CTreeCtrl::HitTest

CTreeCtrl::HitTest

 

调用此函数确定指定的位置点相对树视图控件的工作区的。

HTREEITEM HitTest( 
   CPoint pt, 
   UINT* pFlags = NULL 
) const; 
HTREEITEM HitTest( 
   TVHITTESTINFO* pHitTestInfo 
) const;

参数

 

 pt

测试的点工作区坐标。

pFlags

为获取有关命中测试的结果的信息的整数的指针测试。 它可以是一个或多个值列表的"备注"部分的 flags 成员下。

pHitTestInfo

包含该位置命中 TVHITTESTINFO 结构的地址测试和获取有关命中测试的结果的信息。

返回值

 

 所指定的树视图项目中处理点或 NULL，如果项目不占据点。

备注

 

 当调用该函数时时，pt 参数指定点的坐标测试。 如果项目不占据点，该函数返回指定的项的处理点或 NULL。 此外，pFlags 参数包含一个值来指定点的位置。 可能的值包括：

 

Value	含义
TVHT_ABOVE	在客户端区域。
TVHT_BELOW	在工作区中。
TVHT_NOWHERE	在工作区，但是，在最后一项下。
TVHT_ONITEM	在位图或标签与项目。
TVHT_ONITEMBUTTON	在按钮上与项目。
TVHT_ONITEMICON	在位图与项目。
TVHT_ONITEMINDENT	在缩进与项目。
TVHT_ONITEMLABEL	在标签(字符串)与项目。
TVHT_ONITEMRIGHT	在项目右边的区域。
TVHT_ONITEMSTATEICON	在一个用户定义状态的树视图项的状态图标。
TVHT_TOLEFT	在工作区左边。
TVHT_TORIGHT	在工作区的右侧。

示例

 

 C++

 

// 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