CTreeCtrl::Select

指定されたツリー ビュー アイテムを選択するか、項目をスクロールして表示するか、ドラッグ アンド ドロップ操作のターゲットを指定するために使用されるスタイルの項目を再描画する場合は、この関数を呼び出します。

BOOL Select(
   HTREEITEM hItem,
   UINT nCode 
);

パラメーター

  • hItem
    ツリー項目のハンドル。

  • nCode
    実行するアクションの種類。このパラメーターの値は次の 1 つです:

    • TVGN_CARET は、特定の項目にオプションを設定します。

    • TVGN_DROPHILITE は、ドラッグ アンド ドロップ操作のターゲットを示すために使用するスタイルの特定の項目を再描画します。

    • TVGN_FIRSTVISIBLE は、特定の項目が最初に表示されるアイテムであるように、ツリー ビューを上下にスクロールします。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

nCode が TVGN_CARET値が含まれている場合、親ウィンドウが TVN_SELCHANGINGTVN_SELCHANGED の通知メッセージを受け取ります。また、指定した項目が折りたたまれた親項目の子である場合、指定した項目を展開して、子項目の親リストが展開されます。この場合、親ウィンドウが TVN_ITEMEXPANDINGTVN_ITEMEXPANDED の通知メッセージを受け取ります。

使用例

CTreeCtrl::HitTestの例を参照してください。

必要条件

ヘッダー: afxcmn.h

参照

関連項目

CTreeCtrl クラス

階層図

CTreeCtrl::SelectItem

CTreeCtrl::GetSelectedItem

CTreeCtrl::SelectDropTarget