TVM_GETISEARCHSTRING メッセージ

ツリー ビュー コントロールの増分検索文字列を取得します。 ツリー ビュー コントロールは、増分検索文字列を使用して、ユーザーが入力した文字に基づいて項目を選択します。 このメッセージは、明示的に送信することも、 TreeView_GetISearchString マクロを使用して送信することもできます。

パラメーター

wParam

ゼロを指定してください。

lParam

増分検索文字列を受け取るバッファーへのポインター。

戻り値

増分検索文字列の文字数を返します。

解説

セキュリティの警告: このメッセージを誤って使用すると、プログラムのセキュリティが損なわれる可能性があります。 文字列を保持するのに十分な大きさのバッファーを割り当てる必要があります。 最初に、lParam で NULL を渡すメッセージを呼び出します。 これにより、 必要な NULL を除く文字数が返されます。 次に、メッセージを 2 回目に呼び出して文字列を取得します。 続行する前に 、「セキュリティに関する考慮事項: Microsoft Windows コントロール 」を確認する必要があります。

ツリー ビュー コントロールが増分検索モードでない場合、戻り値は 0 になります。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップ アプリのみ]
ヘッダー	Commctrl.h
Unicode 名と ANSI 名	TVM_GETISEARCHSTRINGW (Unicode) と TVM_GETISEARCHSTRINGA (ANSI)