CMFCPropertyGridCtrl::HitTest

检索指向对应于属性网格控件项目的属性对象，如果指定的点在项目。此方法还指明了在包含该点的属性网格控件的区域。

CMFCPropertyGridProperty* HitTest(
   CPoint pt,
   CMFCPropertyGridProperty::ClickArea* pnArea=NULL,
   BOOL bPropsOnly=FALSE 
) const;

参数

[in] pt
点，在工作区坐标。
[in，out] pnArea
为 ClickArea 变量的指针。当此方法返回时，变量指示包含指定的点的属性区域。有关属性区域的更多信息，请参见备注。
[in] bPropsOnly
测试特性区域的TRUE ;测试声明区域的FALSE，如果指定的点不在属性区域。默认值为 FALSE。有关声明区域的更多信息，请参见备注。

如果 bPropsOnly 参数是 TRUE，并指定的点在属性区域，则返回值是指向相应的属性对象。此外，pnArea 参数设置为包含指定的点的特定区域。否则，返回值是 NULL，但不修改 pnArea 参数。

如果 bPropsOnly 参数是 FALSE，返回值始终为 NULL。但是，因此，如果指定的点在声明区域，pnArea 参数设置为 CMFCPropertyGridProperty::ClickDescription。

术语属性区域引用任何一个名称，值或扩展属性网格控件项目的框区域。声明区域是区域在属性网格控件的底部。在单击属性网格控件项目时，声明区域显示了相应的属性的描述。

此方法设置 pnArea 参数指向变量的值。下表列出了可能的值和相应的区域。

值	区域
ClickArea::ClickExpandBox	特性扩展框控件。
ClickArea::ClickName	属性名。
ClickArea::ClickValue	属性值。
CMFCPropertyGridProperty::ClickDescription	属性网格控件声明区域。

标头: afxpropertygridctrl.h