TreeView_SelectSetFirstVisible マクロ (commctrl.h)

  • [アーティクル]

ツリー ビュー コントロールを垂直方向にスクロールして、指定した項目が確実に表示されるようにします。 可能であれば、指定した項目がコントロールのウィンドウの上部にある最初に表示される項目になります。 このマクロまたは TreeView_Select マクロを使用することも、TVM_SELECTITEM メッセージを明示的に送信することもできます。

構文

BOOL TreeView_SelectSetFirstVisible(
   HWND      hwnd,
   HTREEITEM hitem
);

パラメーター

hwnd

型: HWND

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

hitem

型: HTREEITEM

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

戻り値

型: BOOL

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

備考

ツリー ビュー コントロールには、ウィンドウに収まる数の項目が表示されます。 指定した項目がコントロールの項目階層の下部付近にある場合、ウィンドウに収まる項目の数によっては、最初に表示される項目にならない可能性があります。

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

TreeView_SelectSetFirstVisible マクロの使用は、TVGN_FIRSTVISIBLE値に設定された フラグ パラメーターを使用して TVM_SELECTITEM メッセージを送信することと同じです。

必要条件

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