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

请参见

参考

CTreeCtrl Class

层次结构图

CTreeCtrl::GetItemRect