CTreeCtrl::HitTest
调用此函数确定指定的位置点相对树视图控件的工作区的。
HTREEITEM HitTest(
CPoint pt,
UINT* pFlags = NULL
) const;
HTREEITEM HitTest(
TVHITTESTINFO* pHitTestInfo
) const;
参数
pt
测试的点工作区坐标。pFlags
为获取有关命中测试的结果的信息的整数的指针测试。 它可以是一个或多个值列表的"备注"部分的 flags 成员下。pHitTestInfo
包含该位置命中 TVHITTESTINFO 结构的地址测试和获取有关命中测试的结果的信息。
返回值
所指定的树视图项目中处理点或 NULL,如果项目不占据点。
备注
当调用该函数时时,pt 参数指定点的坐标测试。 如果项目不占据点,该函数返回指定的项的处理点或 NULL。 此外,pFlags 参数包含一个值来指定点的位置。 可能的值包括:
值 |
含义 |
TVHT_ABOVE |
在客户端区域。 |
TVHT_BELOW |
在工作区中。 |
TVHT_NOWHERE |
在工作区,但是,在最后一项下。 |
TVHT_ONITEM |
在位图或标签与项目。 |
TVHT_ONITEMBUTTON |
在按钮上与项目。 |
TVHT_ONITEMICON |
在位图与项目。 |
TVHT_ONITEMINDENT |
在缩进与项目。 |
TVHT_ONITEMLABEL |
在标签(字符串)与项目。 |
TVHT_ONITEMRIGHT |
在项目右边的区域。 |
TVHT_ONITEMSTATEICON |
在一个用户定义状态的树视图项的状态图标。 |
TVHT_TOLEFT |
在工作区左边。 |
TVHT_TORIGHT |
在工作区的右侧。 |
示例
// Select the item that is at the point myPoint.
UINT uFlags;
HTREEITEM hItem = m_TreeCtrl.HitTest(myPoint, &uFlags);
if ((hItem != NULL) && (TVHT_ONITEM & uFlags))
{
m_TreeCtrl.SelectItem(hItem);
}
要求
Header: afxcmn.h