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));