CListCtrl::FindItem

Artykuł
02/27/2013

Wyszukiwanie elementu widoku listy, posiadające określone cechy.

int FindItem(
   LVFINDINFO* pFindInfo,
   int nStart = -1 
) const;

Parametry

pFindInfo
Wskaźnik do LVFINDINFO struktury zawierającej informacje o elementach, które mają być wyszukiwane.
nStart
Indeks elementu, aby rozpocząć wyszukiwanie lub -1, aby rozpocząć od początku.Element w nStart jest wyłączone z wyszukiwania, jeśli nStart nie jest równa -1.

Wartość zwracana

Indeks elementu, jeśli kończy się pomyślnie, lub inaczej -1.

Uwagi

pFindInfo Parametru wskazuje na LVFINDINFO strukturę, która zawiera informacje używane do wyszukiwania dla elementu widoku listy.

Przykład

        LVFINDINFO info;
        int nIndex;

        info.flags = LVFI_PARTIAL|LVFI_STRING;
        info.psz = _T("item");

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