次の方法で共有


CListBox::SelectString

一致する項目が見つかった場合、指定した文字列に一致するリスト ボックスの項目の検索、項目を選択します。

int SelectString(
   int nStartAfter,
   LPCTSTR lpszItem 
);

パラメーター

  • nStartAfter
    検索する最初の項目の前の項目のインデックスが含まれています。検索はリスト ボックスの下部に到達すると、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

参照

関連項目

CListBox クラス

階層図

CListBox::FindString

LB_SELECTSTRING