BCGControlBar Pro for MFC
virtual CBCGPProp* CBCGPPropList::HitTest ( CPoint  pt,
CBCGPProp::ClickArea *  pnArea = NULL,
BOOL  bPropsOnly = FALSE 
) const
virtual

Given a point (in the client coordinates) returns a pointer to a property and the property area.

Returns
A pointer to a property object or NULL.

Tests the specified point and returns a pointer to a property object containing the point. Also, if any property contains the point, pnArea will contain one of the following values:

  • ClickExpandBox - cursor is located in the expand box area
  • ClickName - cursor is located in the item name area
  • ClickValue - cursor is located in the item value area
  • ClickDescription - cursor located in the item description area
  • ClickMenuButton - cursor is located in the item menu button
  • ClickGroupArea - cursor is located in group caption area
Parameters
ptSpecifies the point to test (in the client coordinates)
pnAreaWhen the function returns will contain a code of the specific property area containing the point.
bPropsOnlyWhen this parameter is TRUE, the testing is perfromed on the properties only and all other areas will be ignored.