ListView_GetISearchString マクロ (commctrl.h)
リスト ビュー コントロールの増分検索文字列を取得します。 このマクロを使用することも、 LVM_GETISEARCHSTRING メッセージを明示的に送信することもできます。
構文
void ListView_GetISearchString(
hwndLV,
lpsz
);
パラメーター
hwndLV
種類: HWND
リスト ビュー コントロールへのハンドル。
lpsz
種類: LPSTR
増分検索文字列を受け取るバッファーへのポインター。 文字列の長さを取得するには、 lpsz を NULL に設定 します。
戻り値
なし
解説
増分検索文字列は、リスト ビューに入力フォーカスがある間にユーザーが入力する文字シーケンスです。 ユーザーが文字を入力するたびに、検索文字列に文字が追加され、一致する項目が検索されます。 一致するものが見つかると、項目が選択され、必要に応じてスクロールして表示されます。
タイムアウト期間は、ユーザーが入力した各文字に関連付けられます。 ユーザーが別の文字を入力する前にタイムアウト期間が経過すると、増分検索文字列がリセットされます。
バッファーが文字列を保持するのに十分な大きさであることを確認します。 小さすぎると、すぐに無効なページ フォールトが発生します。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
対象プラットフォーム | Windows |
ヘッダー | commctrl.h |