LVFINDINFO structure

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.

Syntax


typedef struct tagLVFINDINFO {
  UINT    flags;
  LPCTSTR psz;
  LPARAM  lParam;
  POINT   pt;
  UINT    vkDirection;
} LVFINDINFO, *LPFINDINFO;

Members

flags

Type: UINT

Type of search to perform. This member can be set to one or more of the following values:

ValueMeaning
LVFI_PARAM

Searches for a match between this structure's lParam member and the lParam member of an item's LVITEM structure.

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. However, the search is case-insensitive.

LVFI_SUBSTRING

Windows Vista and later. Equivalent to LVFI_PARTIAL.

LVFI_WRAP

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.

LVFI_NEARESTXY

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

This member is valid only if LVFI_NEARESTXY is set in the flags member.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Commctrl.h

Unicode and ANSI names

LVFINDINFOW (Unicode) and LVFINDINFOA (ANSI)

 

 

Community Additions

ADD
Show:
© 2014 Microsoft