TreeView_GetISearchString マクロ (commctrl.h)

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

構文

void TreeView_GetISearchString(
   hwndTV,
   lpsz
);

パラメーター

hwndTV

種類: HWND

ツリー ビュー コントロールを処理します。

lpsz

種類: LPTSTR

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

戻り値

なし

解説

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

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

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	commctrl.h