TreeView_Select マクロ (commctrl.h)

  • [アーティクル]

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

構文

void TreeView_Select(
   hwnd,
   hitem,
   code
);

パラメーター

hwnd

種類: HWND

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

hitem

型: HTREEITEM

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

code

型: UINT

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

値 意味
TVGN_CARET
 選択範囲を指定した項目に設定します。 コントロールの親ウィンドウは、 TVN_SELCHANGING と TVN_SELCHANGED 通知コードを受け取ります。
TVGN_DROPHILITE
 ドラッグ アンド ドロップ操作のターゲットを示すために使用されるスタイルで、指定された項目を再描画します。
TVGN_FIRSTVISIBLE
 指定した項目が確実に表示され、可能な場合はコントロールのウィンドウの上部に表示されます。 ツリー ビュー コントロールには、ウィンドウに収まる数の項目が表示されます。 指定した項目がコントロールの項目階層の下部に近い場合、ウィンドウに収まる項目の数によっては、最初に表示される項目にならない場合があります。

戻り値

なし

解説

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

要件

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