Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This structure contains information used to search for a list-view item. This structure is identical to the LVFINDINFOstructure, but was renamed to fit standard naming conventions.

Syntax 

typedef struct _LV_FINDINFO {
  UINT 
flags; 
  LPCSTR 
psz; 
  LPARAM 
lParam; 
  POINT 
pt; 
  UINT 
vkDirection; 
} LV_FINDINFO;

Members

flags

Type of search to perform. It can be one or more of the following values.

Value Description

LVFI_PARAM

Searches based on the lParammember. The lParammember of the matching item's LVITEMstructure must match the lParammember of this structure. If this value is specified, all other values are ignored.

LVFI_PARTIAL

Checks to see if the item text begins with the string pointed to by the pszmember. This value implies use of LVFI_STRING.

LVFI_STRING

Searches based on the item text. Unless additional values are specified, the item text of the matching item must exactly match the string pointed to by the pszmember.

LVFI_WRAP

Continues the search at the beginning if no match is found.

LVFI_NEARESTXY

Finds the item nearest to the position specified in the ptmember, in the direction specified by the vkDirectionmember.
psz

Pointer to a null-terminated string to compare with the item text if flagsspecify LVFI_STRING or LVFI_PARTIAL.

lParam

Value to compare with the lParammember of a list-view item's LVITEMstructure if the flagsmember specifies LVFI_PARAM.

pt

POINTstructure that specifies the starting position to search from. This member is used only if LVFI_NEARESTXY is specified in the flagsmember.

vkDirection

Direction to search. This member contains the virtual key code of an arrow key that corresponds to the direction to search. This member is used only if LVFI_NEARESTXY is specified in the flagsmember.

Requirements

Header commctrl.h
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also