CTreeCtrl::GetItemPartRect

检索一个指定项的指定部分的边框在当前树视图控件的。

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

参数

Parameter

描述

[in] hItem

为树视图控件项目中处理。

[in] nPart

部件的标识符。 必须设置为 TVGIPR_BUTTON。

[out] lpRect

矩形 结构的指针。 如果此方法成功,结构接收 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 方法在该项周围绘制三维矩形。 在代码示例的早期部分,则不会显示,我们在这些状态创建了一个包括美国的,宾夕法尼亚州的子节点根国家/地区节点和华盛顿的一个树视图和城市的树项。 我们使用 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 Class

层次结构图

TreeView_GetItemPartRect

矩形

CTreeCtrl::HitTest