CListCtrl::FindItem

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

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

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