CTreeCtrl::GetItemPartRect
擷取指定之項目的特定部分的週框 (Bounding Rectangle) 目前樹狀檢視控制項的。
BOOL GetItemPartRect(
HTREEITEM hItem,
int nPart,
LPRECT lpRect
)const;
參數
參數 |
描述 |
|---|---|
[in] hItem |
對樹狀檢視控制項項目的控制代碼。 |
[in] nPart |
組件的識別項。 必須設定為 TVGIPR_BUTTON。 |
[out] 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));