Export (0) Print
Expand All
MFC
Expand Minimize

COleControl::OnQueryHitPoint

Called by the framework in response to a container's IViewObjectEx::QueryHitPoint request.

virtual BOOL OnQueryHitPoint(
   DWORD dwAspect,
   LPCRECT pRectBounds,
   POINT ptlLoc,
   LONG lCloseHint,
   DWORD* pHitResult 
);

dwAspect

Specifies how the object is represented. Valid values are taken from the enumeration DVASPECT or DVASPECT2.

pRectBounds

Pointer to a RECT structure specifying the bounding rectangle of the OLE control client area.

ptlLoc

Pointer to the POINT structure specifying the point to be checked for a hit. The point is specified in OLE client area coordinates.

lCloseHint

The distance that defines "close" to the point checked for a hit.

pHitResult

Pointer to the result of the hit query. One of the following values:

  • HITRESULT_OUTSIDE   ptlLoc is outside the OLE object and not close.

  • HITRESULT_TRANSPARENT   ptlLoc is within the bounds of the OLE object, but not close to the image. For example, a point in the middle of a transparent circle could be HITRESULT_TRANSPARENT.

  • HITRESULT_CLOSE   ptlLoc is inside or outside the OLE object but close enough to the object to be considered inside. Small, thin, or detailed objects may use this value. Even if a point is outside the bounding rectangle of an object it may still be close (this is needed for hitting small objects).

  • HITRESULT_HIT   ptlLoc is within the image of the object.

Nonzero if a hit result is successfully returned; otherwise 0. A hit is an overlap with the OLE control display area.

Queries whether an object's display rectangle overlaps the given point (hits the point). QueryHitPoint can be overridden to test hits for non-rectangular objects.

Header: afxctl.h

Community Additions

ADD
Show:
© 2014 Microsoft