COleControl::OnQueryHitPoint

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

返回值:
如果成功返回一次命中结果,则返回非零值,否则为0。一次命中指OLE控件的显示区的一次覆盖。

参数:
dwAspect描述一个对象的显示外观或形式的DWORD值。其有效值取自DVASPECT或DVASPECT2。
pRectBounds一个RECT结构指针,该结构指定OLE控件客户区的边界矩形。
ptlLoc一个POINT结构指针,该结构指定一次命中的检查点。该点使用OLE控件客户区坐标说明。
lCloseHint定义“接近”命中检查点的距离。
pHitResult命中检查的结果指针。可以为下列值:
·HITRESULT_OUTSIDEptlLoc处于OLE对象的外部并且不接近。
·HITRESULT_TRANSPARENTptlLoc在OLE对象边界内,但不接近图象。例如,一个处于透明圆的中心的点可能属于这种HITRESULT_TRANSPARENT。
·HITRESULT_CLOSEptlLoc处于OLE对象的内部或外部,但它和对象足够接近,因此可以认为在对象内。小的、瘦的或细节的对象可以使用该值。即使一个点处于对象的边界矩形的外面,它也可能和对象很接近(这在命中小对象时是必需的)。
·HITRESULT_HITptlLoc处于对象的图象内。

说明:
框架调用以响应包容器的IViewObjectEx::QueryHitPoint请求。它用于检查对象的显示区域是否覆盖已指定点(命中该点)。QueryHitPoint可以覆盖以对非矩形对象进行命中检查。

请参阅:COleControl::OnQueryHitRect