LB_SELECTSTRING メッセージ
リスト ボックスで、指定した文字列内の文字で始まる項目を検索します。 一致する項目が見つかった場合は、項目が選択されます。
パラメーター
-
wParam
-
最初の検索対象項目の前にある項目の 0 から始まるインデックス番号。 検索がリスト ボックスの一番下に達すると、リスト ボックスの上部から wParam パラメーターで指定された項目に戻ります。 wParam が -1 の場合、リスト ボックス全体が最初から検索されます。
Windows 95/Windows 98/Windows Millennium Edition (Windows Me) : wParam パラメーターは 16 ビット値に制限されています。 つまり、リスト ボックスには 32,767 個を超えるアイテムを含めることはできません。 項目の数は制限されていますが、リスト ボックス内のアイテムの合計サイズ (バイト単位) は、使用可能なメモリによってのみ制限されます。
-
lParam
-
検索するプレフィックスを含む null で終わる文字列へのポインター。 検索では大文字と小文字が区別されないため、この文字列には大文字と小文字の任意の組み合わせを含めることができます。
戻り値
検索が成功した場合、戻り値は選択した項目のインデックスになります。 検索が失敗した場合、戻り値はLB_ERRされ、現在の選択範囲は変更されません。
解説
必要に応じて、リスト ボックスがスクロールされ、選択した項目が表示されます。
このメッセージは、LBS_MULTIPLESELまたはLBS_EXTENDEDSELスタイルを含むリスト ボックスには使用しないでください。
項目が選択されるのは、開始点の最初の文字が 、lParam パラメーターで指定された文字列内の文字と一致する場合のみです。
リスト ボックスに所有者描画スタイルがあり、 LBS_HASSTRINGS スタイルがない場合、 LB_SELECTSTRING によって実行されるアクションは 、LBS_SORT スタイルが使用されているかどうかによって異なります。 LBS_SORTが使用されている場合、システムはWM_COMPAREITEMメッセージをリスト ボックス所有者に送信して、指定した文字列と一致する項目を決定します。 それ以外の場合、LB_SELECTSTRINGは、lParam パラメーターと一致する長い値 (LB_ADDSTRINGまたはLB_INSERTSTRING メッセージの lParam パラメーターとして指定) を持つアイテムを検索しようとします。
必要条件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows Server 2003 [デスクトップ アプリのみ] |
| Header |
|