COleControl::OnQueryHitPoint

呼叫框架回應容器的 IViewObjectEx::QueryHitPoint 要求。

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

參數

  • dwAspect
    指定物件的表示。有效值是從列舉型別 DVASPECTDVASPECT2中取得。

  • pRectBounds
    RECT 結構的指標指定 OLE 控制項工作區的週框。

  • ptlLoc
    結構的指標指定的點會檢查叫用。指向 OLE 工作區座標所指定。

  • lCloseHint
    定義「關閉」為點距離檢查以叫用。

  • pHitResult
    要叫用的查詢結果的指標。下列其中一個值:

    • HITRESULT_OUTSIDE   ptlLoc 是而非 OLE 物件關閉之外。

    • HITRESULT_TRANSPARENT   在ptlLoc OLE 物件的不是繫結,不過,關閉中的影像。例如,在某個透明圓形中間的點可以是 HITRESULT_TRANSPARENT

    • HITRESULT_CLOSE   ptlLoc 位於 OLE 足夠物件,但是關閉之外的任何位置會被考慮的物件內。小型細窄,或是詳細的物件可以使用這個值。即使是外部物件週框 (Bounding Rectangle) 它仍然是關閉 (此為點擊小型物件所需的權限)。

    • HITRESULT_HIT   ptlLoc 物件中的影像中。

傳回值

如果不是零,叫用結果成功傳回,則為 0。叫用與 OLE 控制項顯示區域的重疊。

備註

查詢物件的顯示矩形是否重疊指定點 (點擊點)。QueryHitPoint 可以覆寫為非矩形物件測試叫用。

需求

Header: afxctl.h

請參閱

參考

COleControl 類別

階層架構圖

COleControl::OnQueryHitRect