CB_SELECTSTRING メッセージ

コンボ ボックスの一覧で、指定した文字列内の文字で始まる項目を検索します。 一致する項目が見つかった場合は、その項目が選択され、編集コントロールにコピーされます。

パラメーター

wParam

検索する最初の項目の前にある項目の 0 から始まるインデックス。 検索がリストの一番下に達すると、リストの先頭から wParam パラメーターで指定された項目に戻ります。 wParam が -1 の場合、リスト全体が最初から検索されます。

lParam

検索対象の文字を含む null で終わる文字列へのポインター。 検索では大文字と小文字が区別されないため、この文字列には大文字と小文字の任意の組み合わせを含めることができます。

戻り値

文字列が見つかった場合、戻り値は選択した項目のインデックスです。 検索が失敗した場合、戻り値はCB_ERRされ、現在の選択範囲は変更されません。

解説

文字列は、開始点の文字がプレフィックス文字列の文字と一致する場合にのみ選択されます。

所有者が描画したスタイルで、 CBS_HASSTRINGS スタイルを使用せずにコンボ ボックスを作成する場合、 CB_SELECTSTRING メッセージの動作は 、CBS_SORT スタイルを使用するかどうかによって異なります。 CBS_SORT スタイルを使用すると、コンボ ボックスの所有者にWM_COMPAREITEMメッセージが送信され、指定した文字列と一致する項目が決定されます。 CBS_SORT スタイルを使用しない場合、CB_SELECTSTRINGは DWORD 値と lParam パラメーターの値との照合を試みます。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップ アプリのみ]
ヘッダー	Winuser.h (Windows.h を含む)

関連項目

参照

CB_FINDSTRING

CB_FINDSTRINGEXACT

CB_SETCURSEL

WM_COMPAREITEM