CListCtrl::FindItem

[アーティクル]
08/09/2011

指定した特性を持つリストビューアイテムを検索します。

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

パラメーター

pFindInfo
検索されるアイテムについての情報を保持する LVFINDINFO 構造体へのポインター。
nStart
検索を開始するアイテムのインデックス。先頭から検索するときは -1 を指定します。 nStart が -1 ではないときは、nStart に相当たるアイテムは検索の対象から除外されます。

戻り値

正常終了した場合はアイテムのインデックスを返します。それ以外の場合は -1 を返します。

解説

パラメーター pFindInfo は LVFINDINFO 構造体のポインターです。この構造体はリストビューアイテムの検索に使う情報を持っています。

使用例

        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);
        }