CListBox::FindStringExact

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

更新 : 2007 年 11 月

リストボックスの中から、lpszFind で指定された文字列と一致する最初の文字列を検索します。

int FindStringExact(
   int nIndexStart,
   LPCTSTR lpszFind 
) const;

パラメータ

nIndexStart
検索を開始する項目の直前の項目を 0 から始まるインデックスで指定します。リストボックスの最後まで検索すると、リストボックスの先頭の項目に戻り、nIndexStart で指定した項目まで検索を続けます。nIndexStart に -1 を指定すると、リストボックス全体を先頭から検索します。
lpszFind
検索する NULL で終わる文字列へのポインタ。この文字列には、拡張子を含めた完全なファイル名を指定できます。検索では、大文字、小文字を区別しないので、文字列中に大文字、小文字が混在してもかまいません。

戻り値

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

解説

LBS_HASSTRINGS スタイルのないオーナー描画スタイルで作られているリストボックスでは、FindStringExact メンバ関数は lpszFind の値をダブルワード値として比較し、検索します。

使用例

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

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