CComboBox::FindStringExact

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

更新 : 2007 年 11 月

コンボボックスのリストボックスで、lpszFind で指定した文字列に一致する最初の項目を検索します。

int FindStringExact(
   int nIndexStart,
   LPCTSTR lpszFind 
) const;

パラメータ

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

戻り値

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

解説

コンボボックスが CBS_HASSTRINGS スタイルではなく、オーナー描画スタイルで作成されている場合、FindStringExact 関数は、lpszFind で指定した値に対するダブルワード値を検索します。

使用例

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

// Delete all items that exactly match the specified string.
int nDex = 0;
while ((nDex = m_pComboBox->FindStringExact(nDex, lpszmyExactString)) 
   != CB_ERR)
{
   m_pComboBox->DeleteString(nDex);
}