LB_FINDSTRING メッセージ

指定した文字列で始まるリスト ボックス内の最初の文字列を検索します。

パラメーター

wParam

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

Windows 95/Windows 98/Windows Millennium Edition (Windows Me) : wParam パラメーターは 16 ビット値に制限されています。 つまり、リスト ボックスには 32,767 個を超えるアイテムを含めることはできません。 項目の数は制限されていますが、リスト ボックス内のアイテムの合計サイズ (バイト単位) は、使用可能なメモリによってのみ制限されます。

lParam

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

戻り値

戻り値は、一致する項目のインデックスです。検索が失敗した場合はLB_ERR。

解説

リスト ボックスに所有者描画スタイルがあり、 LBS_HASSTRINGS スタイルがない場合、 LB_FINDSTRING によって実行されるアクションは 、LBS_SORT スタイルが使用されているかどうかによって異なります。 LBS_SORTが使用されている場合、システムはWM_COMPAREITEMメッセージをリスト ボックス所有者に送信して、指定した文字列と一致する項目を決定します。 それ以外の場合、LB_FINDSTRINGは、lParam パラメーターに一致する長い値 (LB_ADDSTRINGまたはLB_INSERTSTRING メッセージの lParam パラメーターとして指定) を持つ項目を検索しようとします。

要件

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

関連項目

LB_FINDSTRINGEXACT