TreeView_Select マクロ (commctrl.h)

  • [アーティクル]

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

構文

BOOL TreeView_Select(
   HWND      hwnd,
   HTREEITEM hitem,
   UINT      code
);

パラメーター

hwnd

型: HWND

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

hitem

型: HTREEITEM

アイテムへのハンドル。 hitem パラメーターが NULL場合、コントロールには選択された項目が設定されません。

code

型: UINT

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

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

戻り値

型: BOOL

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

備考

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

必要条件

要件 価値
サポートされる最小クライアント Windows Vista [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2003 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー commctrl.h