CTreeCtrl::GetItemPartRect
現在のツリー ビュー コントロール内の指定されたアイテムの指定された部分に外接する四角形を取得します。
BOOL GetItemPartRect(
HTREEITEM hItem,
int nPart,
LPRECT lpRect
)const;
パラメーター
パラメーター |
説明 |
|---|---|
[入力] hItem |
ツリー ビュー コントロールのアイテムへのハンドル。 |
[入力] nPart |
一部の識別子。TVGIPR_BUTTON に設定する必要があります。 |
[出力] lpRect |
RECT の構造体へのポインター。このメソッドが成功した場合、構造体は hItem と nPartで指定された部分の四角形の座標を受け取ります。 |
戻り値
このメソッドが成功した場合は true。それ以外の場合は false。
解説
各ツリー ビュー コントロールのアイテムは、グラフィックの四角形で区切ります。その四角形内のポイントがクリックされると、項目はヒットする と呼ばれます。このメソッドは、四角形のポイントをクリックすると、hItem のパラメーターで指定された項目はヒットします。最大の四角形を返します。
このメソッドは Windows SDKで説明する TVM_GETITEMPARTRECT のメッセージを送信します。詳細については、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 のメソッドを使用します。この例では、ハンドルおよびその項目の周囲に3Dの四角形の描画に CTreeCtrl::GetItemPartRect のメソッドを使用します。表示されていないコード例では、前のセクションでは、米国のルートの国または地域のノード、およびワシントン州ペンシルバニア状態のサブノードで構成される、これらの状態の都市のツリー項目のツリー ビューを作成しました。ここでは、アクセシビリティ識別子によってルートのツリー ビュー アイテムを関連付けるに 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));