ListView_GetISearchString マクロ (commctrl.h)

リストビューコントロールの増分検索文字列を取得します。このマクロを使用することも、LVM_GETISEARCHSTRING メッセージを明示的に送信することもできます。

構文

BOOL ListView_GetISearchString(
   HWND  hwndLV,
   LPSTR lpsz
);

hwndLV

型: HWND

リストビューコントロールのハンドル。

lpsz

型: LPSTR

増分検索文字列を受け取るバッファーへのポインター。文字列の長さを取得するには、lpsz NULL設定します。

型: BOOL

増分検索文字列の文字数を返します。リストビューコントロールが増分検索モードでない場合は 0 を返します。

増分検索文字列は、リストビューに入力フォーカスがある間にユーザーが入力する文字シーケンスです。ユーザーが文字を入力するたびに、検索文字列に文字が追加され、一致する項目が検索されます。一致が見つかると、項目が選択され、必要に応じてスクロールして表示されます。

タイムアウト期間は、ユーザーが入力した各文字に関連付けられます。ユーザーが別の文字を入力する前にタイムアウト期間が経過すると、増分検索文字列がリセットされます。

バッファーが文字列を保持するのに十分な大きさであることを確認します。小さすぎると、すぐに無効なページエラーが発生します。