CListBox::FindString

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

更新 : 2007 年 11 月

指定したプリフィックスを持つ最初の文字列をリストボックス内で検索します。リストボックスの選択は変更しません。

int FindString(
   int nStartAfter,
   LPCTSTR lpszItem 
) const;

パラメータ

nStartAfter
検索を開始する項目の直前の項目を 0 から始まるインデックスで指定します。リストボックスの最後まで検索すると、リストボックスの先頭の項目に戻り、nStartAfter で指定した項目まで検索を続けます。nStartAfter に -1 を指定すると、リストボックス全体を先頭から検索します。
lpszItem
NULL で終わり、検索するプリフィックスを含む文字列へのポインタ。検索では大文字と小文字が区別されないので、文字列に大文字と小文字が混在していてもかまいません。

戻り値

一致する項目の 0 から始まるインデックスを返します。見つからなかった場合は LB_ERR を返します。

解説

SelectString メンバ関数では、検索と選択を同時にできます。

使用例

   // The string to match.
LPCTSTR lpszmyString = _T("item");

// Delete all items that begin with the specified string.
int nIndex = 0;
while ((nIndex = m_myListBox.FindString(nIndex, lpszmyString)) != LB_ERR)
{
   m_myListBox.DeleteString( nIndex );
}