TVM_SELECTITEM メッセージ

指定したツリー ビュー項目を選択するか、項目をビューにスクロールするか、ドラッグ アンド ドロップ操作のターゲットを示すために使用されるスタイルで項目を再描画します。 このメッセージは、明示的に送信することも、TreeView_Select、TreeView_SelectItem、またはマクロTreeView_SelectDropTarget使用して送信することもできます。

パラメーター

wParam

アクション フラグ。 このパラメーターには、次のいずれかの値を指定できます。

値	説明
TVGN_CARET	選択範囲を指定した項目に設定します。 ツリー ビュー コントロールの親ウィンドウは、 TVN_SELCHANGING と TVN_SELCHANGED 通知コードを受け取ります。
TVGN_DROPHILITE	ドラッグ アンド ドロップ操作のターゲットを示すために使用するスタイルで、指定した項目を再描画します。
TVGN_FIRSTVISIBLE	指定した項目が確実に表示され、可能な場合はコントロールのウィンドウの上部に表示されます。 ツリー ビュー コントロールには、ウィンドウに収まる数の項目が表示されます。 指定した項目がコントロールの項目階層の下部に近い場合、ウィンドウに収まる項目の数によっては、最初に表示される項目にならない場合があります。
TVSI_NOSINGLEEXPAND	1 つの項目を選択すると、ツリービューでその項目の子が展開されないようにします。 これは、TVGN_CARET フラグと共に使用する場合にのみ有効です。 メモ： このフラグを使用するには、バージョン 6.0 Comclt32.dll 指定するマニフェストを指定する必要があります。 マニフェストの詳細については、「 ビジュアル スタイルの有効化」を参照してください。

lParam

項目へのハンドル。 lParam が NULL の場合、コントロールは選択された項目を持たないことを設定します。

戻り値

成功した場合は TRUE 、それ以外の場合 は FALSE を 返します。

解説

指定した項目が折りたたまれた親アイテムの子である場合、親の子項目のリストが展開され、指定した項目が表示されます。 この場合、コントロールの親ウィンドウは 、TVN_ITEMEXPANDING と TVN_ITEMEXPANDED 通知コードを受け取ります。

TreeView_SelectItem マクロの使用は、wParam がTVGN_CARET値に設定されたTVM_SELECTITEM メッセージを送信することと同じです。 TreeView_SelectDropTarget マクロの使用は、wParam が TVGN_DROPHILITE 値に設定されたTVM_SELECTITEM メッセージを送信することと同じです。 TreeView_SelectSetFirstVisibleの使用は、wParam が TVGN_FIRSTVISIBLE 値に設定されたTVM_SELECTITEM メッセージを送信することと同じです。

必要条件

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