LV_FINDINFO

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

At a Glance

Header file: Commctrl.h
Windows CE versions: 1.0 and later

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 lParam member. The lParam member of the matching item’s LV_ITEM structure must match the lParam member 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 psz member. 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 psz member.
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 pt member, in the direction specified by the vkDirection member.

psz

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

lParam

Value to compare with the lParam member of a list view item’s LV_ITEM structure if the flags member specifies LVFI_PARAM.

pt

POINT structure that specifies the starting position to search from. This member is used only if LVFI_NEARESTXY is specified in the flags member.

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 flags member.

See Also

LVM_FINDITEM, LV_ITEM