CTreeCtrl::GetItemPartRect

[アーティクル]
09/17/2008

更新 : 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));