LVFINDINFOA structure (commctrl.h)
Contains information used when searching for a list-view item. This structure is identical to LV_FINDINFO but has been renamed to fit standard naming conventions.
typedef struct tagLVFINDINFOA {
UINT flags;
LPCSTR psz;
LPARAM lParam;
POINT pt;
UINT vkDirection;
} LVFINDINFOA, *LPFINDINFOA;
flags
Type: UINT
Type of search to perform. This member can be set to one or more of the following values:
Value | Meaning |
---|---|
|
Searches for a match between this structure's lParam member and the lParam member of an item's LVITEM structure. |
|
Checks to see if the item text begins with the string pointed to by the psz member. This value implies use of 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. However, the search is case-insensitive. |
|
Windows Vista and later. Equivalent to LVFI_PARTIAL. |
|
Continues the search at the beginning if no match is found. If this flag is used by itself, it is assumed that a string search is wanted. |
|
Finds the item nearest to the position specified in the pt member, in the direction specified by the vkDirection member. This flag is supported only by large icon and small icon modes. If LVFI_NEARESTXY is specified, all other flags are ignored. |
psz
Type: LPCTSTR
Address of a null-terminated string to compare with the item text. It is valid only if LVFI_STRING or LVFI_PARTIAL is set in the flags member.
lParam
Type: LPARAM
Value to compare with the lParam member of a list-view item's LVITEM structure. It is valid only if LVFI_PARAM is set in the flags member.
pt
Type: POINT
POINT structure with the initial search position. It is valid only if LVFI_NEARESTXY is set in the flags member.
vkDirection
Type: UINT
Virtual key code that specifies the direction to search. The following codes are supported:
- VK_LEFT
- VK_RIGHT
- VK_UP
- VK_DOWN
- VK_HOME
- VK_END
- VK_PRIOR
- VK_NEXT
Note
The commctrl.h header defines LVFINDINFO as an alias that automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that is not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.
Requirement | Value |
---|---|
Minimum supported client | Windows Vista [desktop apps only] |
Minimum supported server | Windows Server 2003 [desktop apps only] |
Header | commctrl.h |