CTreeCtrl::GetItemPartRect

更新 : 2007 年 11 月

現在のツリー ビュー コントロール内の指定されたアイテムの指定された部分に外接する四角形を取得します。

BOOL GetItemPartRect(
          HTREEITEM hItem, 
          int nPart, 
          LPRECT lpRect
)const;

パラメータ

パラメータ

説明

[入力] hItem

ツリー ビュー コントロール アイテムへのハンドル。

[入力] nPart

対象部分の識別子。TVGIPR_BUTTON に設定する必要があります。

[出力] lpRect

RECT 構造体へのポインタ。このメソッドが成功すると、hItem と nPart で指定されている部分の四角形の座標がその構造体に取り込まれます。

戻り値

このメソッドが成功した場合は true。それ以外の場合は false。

解説

それぞれのツリー コントロール アイテムには、外接する四角形グラフィックスがあります。その四角形の中の点をクリックすることを、そのアイテムをヒットする、といいます。このメソッドは四角形を返します。その四角形は、その中の点をクリックしたときに、hItem パラメータで指定されているアイテムをヒットしたことになる最大の四角形です。

このメソッドは、TVM_GETITEMPARTRECT メッセージを送信します。このメッセージについては、Windows SDK を参照してください。詳細については、TreeView_GetItemPartRect マクロの説明を参照してください。

必要条件

ヘッダー : afxcmn.h

このメソッドは、Windows Vista およびそれ以降のバージョンでサポートされています。

このメソッドに関するその他の要件については、「Windows Vista コモン コントロールの作成要件」を参照してください。

使用例

次のコード例では、現在のツリー ビュー コントロールにアクセスするために使用される変数 m_treeCtrl を定義しています。コード例では、符号なし整数といくつかの HTREEITEM 変数も定義しています。これらの変数は、次の例で使用されます。

public:
    // Variable to access tree control.
    CTreeCtrl m_treeCtrl;
    // Variable to access splitbutton control.
    CSplitButton m_splitbutton;
    // Accessibility identifier
    UINT accIdUS;
    // HTREEITEMs
    HTREEITEM hCountry;
    HTREEITEM hPA;
    HTREEITEM hWA;

次のコード例では、アクセシビリティ識別子と CTreeCtrl::MapAccIdToItem メソッドを使用して、ルート ツリー ビュー アイテムのハンドルを取得します。さらに、ハンドルと CTreeCtrl::GetItemPartRect メソッドを使用して、そのアイテムの周囲に 3D の四角形を描画します。ここには示されていないコード例の前半では、ルート ノードである米国ノード、ペンシルバニア州とワシントン州を表すサブノード、およびこれらの州の都市を表すツリー アイテムから構成されるツリー ビューを作成しました。CTreeCtrl::MapItemToAccID メソッドを使用して、ルート ツリー ビュー アイテムをアクセシビリティ識別子に関連付けました。

  CRect rect;
    HTREEITEM hUS = m_treeCtrl.MapAccIdToItem( accIdUS );
    m_treeCtrl.GetItemPartRect( hUS, TVGIPR_BUTTON, &rect );
    m_treeCtrl.GetDC()->Draw3dRect( &rect, RGB(255, 0, 0), RGB(0, 0, 255));

参照

参照

CTreeCtrl クラス

階層図

TreeView_GetItemPartRect

RECT

CTreeCtrl::HitTest

その他の技術情報

CTreeCtrl のメンバ