CComboBox::FindString

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

更新 : 2007 年 11 月

コンボボックスのリストボックスで、指定したプリフィックスを含む最初の文字列を検索します。ただし、選択はしません。

int FindString(
   int nStartAfter,
   LPCTSTR lpszString 
) const;

パラメータ

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

戻り値

戻り値が 0 以上の場合は、見つかった項目を 0 から始まるインデックスで示します。見つからない場合は、CB_ERR を返します。

解説

この関数は、Windows の ComboBoxEx コントロールではサポートされていません。このコントロールの詳細については、Windows SDK の「ComboBoxEx Controls」を参照してください。

使用例

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

// Delete all items that begin with the specified string.
int nItem = 0;
while ((nItem = m_pComboBox->FindString(nItem, lpszmyString)) != CB_ERR)
{
   m_pComboBox->DeleteString(nItem);
}