CListCtrl::FindItem

intFindItem(LVFINDINFO*pFindInfo, intnStart**= -1) const;**

Return Value

The index of the item if successful or -1 otherwise.

Parameters

pFindInfo

A pointer to a structure containing information about the item to be searched for.

nStart

Index of the item to begin the search with, or -1 to start from the beginning. The item at nStart is excluded from the search if nStart is not equal to -1.

Remarks

Use this function to search for a list view item having specified characteristics.

The pFindInfo parameter points to an LVFINDINFO structure, which contains information used to search for a list view item.

Example

// The pointer to my list view control.
extern CListCtrl* pmyListCtrl;
// The string to match.
extern LPCTSTR lpszmyString;

LVFINDINFO info;
int nIndex;

info.flags = LVFI_PARTIAL|LVFI_STRING;
info.psz = lpszmyString;

// Delete all of the items that begin with the string lpszmyString.
while ((nIndex=pmyListCtrl->FindItem(&info)) != -1)
{
   pmyListCtrl->DeleteItem(nIndex);
}

CListCtrl Overview |  Class Members |  Hierarchy Chart

See Also   CListCtrl::SortItems