CListCtrl::FindItem

更新 : 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);
}

必要条件

ヘッダー : afxcmn.h

参照

参照

CListCtrl クラス

階層図

CListCtrl::SortItems

その他の技術情報

CListCtrl のメンバ