CMFCPropertyGridProperty::HitTest

  • Article

Points to the property object that corresponds to the property list item that corresponds to a point.

CMFCPropertyGridProperty* HitTest(
   CPoint point,
   CMFCPropertyGridProperty::ClickArea* pnArea=NULL 
);

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

Parameters

  • [in] point
    The point to test, in client coordinates. This parameter is typically the current mouse pointer location.

  • [in] pt
    The point to test, in client coordinates.

  • [out] pnArea
    When this method returns, indicates the area that contains the specified point. For more information, see Remarks. The default value is NULL.

  • [in] bPropsOnly
    TRUE to test any area in the property control; FALSE to test only the description area. The default value is FALSE.

Return Value

A pointer to a property object or NULL.

Remarks

By default, this method tests property sub-items if the specified point is not found within any of the property items.

The following table lists the values that can be returned to the pnArea parameter.

Area

Description

ClickArea::ClickExpandBox

The expand box control, which is designated by a plus sign (+).

ClickArea::ClickName

The property name.

ClickArea::ClickValue

The property value.

Requirements

Header: afxpropertygridctrl.h

See Also

Reference

CMFCPropertyGridProperty Class

Hierarchy Chart