ListView_GetISearchString マクロ (commctrl.h)

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

構文

void ListView_GetISearchString(
   hwndLV,
   lpsz
);

hwndLV

種類: HWND

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

lpsz

種類: LPSTR

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

なし

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

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

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