CListBox::SelectString
更新 : 2007 年 11 月
指定した文字列に一致するリスト ボックスの項目を検索し、一致する項目が見つかったときは、その項目を選択します。
int SelectString(
int nStartAfter,
LPCTSTR lpszItem
);
パラメータ
nStartAfter
検索を開始する項目の直前の項目を 0 から始まるインデックスで指定します。リスト ボックスの最後まで検索すると、リスト ボックスの先頭の項目に戻り、nStartAfter で指定した項目まで検索を続けます。nStartAfter に -1 を指定すると、リスト ボックス全体を先頭から検索します。lpszItem
NULL で終わり、検索するプリフィックスを含む文字列へのポインタ。検索では大文字と小文字が区別されないので、文字列に大文字と小文字が混在していてもかまいません。
戻り値
見つかった場合は、選択した項目のインデックスを返します。見つからなかった場合は LB_ERR を返し、現在の選択を変更しません。
解説
選択した項目が表示されるように、必要に応じてリスト ボックスをスクロールします。
このメンバ関数は、LBS_MULTIPLESEL スタイルを持つリスト ボックスには使えません。
lpszItem で指定した文字列と先頭の文字が一致する項目が選択されます。
項目を選択せずに文字列の検索のみを行うには、FindString メンバ関数を使います。
使用例
// The string to match.
LPCTSTR lpszmyString = _T("item 5");
// Select the item that begins with the specified string.
int nIndex = m_myListBox.SelectString(0, lpszmyString);
ASSERT(nIndex != LB_ERR);
必要条件
ヘッダー : afxwin.h