ListView_FindItem macro (commctrl.h)

Searches for a list-view item with the specified characteristics. You can use this macro or send the LVM_FINDITEM message explicitly.

Syntax

int ListView_FindItem(
         HWND         hwnd,
         int          iStart,
   const LPLVFINDINFO plvfi
);

Parameters

hwnd

Type: HWND

A handle to the list-view control.

iStart

Type: int

The index of the item after which to begin the search, or -1 to start from the beginning.

plvfi

Type: const LPLVFINDINFO

A pointer to an LVFINDINFO structure that contains information about what to search for.

Return value

Type: int

Returns the index of the item if successful, or -1 otherwise.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	commctrl.h