Freigeben über


COleControl::OnQueryHitPoint

Aufgerufen vom Framework als Reaktion auf IViewObjectEx::QueryHitPoint Anforderung eines Containers.

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

Parameter

  • dwAspect
    Gibt an, wie das Objekt dargestellt wird.Gültige Werte werden aus der Enumeration DVASPECT oder DVASPECT2 entnommen.

  • pRectBounds
    Zeiger auf eine Struktur RECT des umschließenden Rechtecks des OLE-Steuerelement-Clientbereichs angibt.

  • ptlLoc
    Zeiger auf die POINT-Struktur den für einen Treffer überprüft werden, Punkt angibt.Der Punkt wird in den OLE-Clientbereichskoordinaten angegeben.

  • lCloseHint
    Der Abstand, der "Schließen" zum Punkt definiert, die für einen Treffer.

  • pHitResult
    Zeiger auf das Ergebnis der Trefferabfrage.Einer der folgenden Werte:

    • HITRESULT_OUTSIDE   ptlLoc ist außerhalb des OLE-Objekts und des Abschlusses nicht.

    • HITRESULT_TRANSPARENT   ptlLoc ist innerhalb der Grenzen des OLE-Objekts, aber nicht des Abschlusses zum Bild.Beispielsweise kann ein Punkt mitten in einem transparenten Kreis HITRESULT_TRANSPARENT sein.

    • HITRESULT_CLOSE   ptlLoc ist innerhalb des OLE-Objekts jedoch der Vervollständigung genug zum in Betracht gezogen werden Objekt.Kleine, wenige oder ausführliche Objekte können diesen Wert.Auch wenn ein Punkt außerhalb des umgebenden Rechtecks eines Objekts ist, kann es noch Abschluss (wird für das Anstoßen von kleine Objekte erforderlich).

    • HITRESULT_HIT   ptlLoc ist im Bild des Objekts.

Rückgabewert

Ungleich 0 (null), wenn ein Trefferergebnis erfolgreich zurückgegeben wird; andernfalls 0.Ein Treffer ist eine Überlappung mit dem OLE-Kontrollanzeigebereich.

Hinweise

Fragt ob Anzeigen-Rechtecküberschneidungen eines Objekts der angegebene Punkt ab (Treffer der Punkt).QueryHitPoint kann überschrieben werden, um Treffer für nicht rechteckige Objekte zu testen.

Anforderungen

Header: afxctl.h

Siehe auch

Referenz

COleControl-Klasse

Hierarchien-Diagramm

COleControl::OnQueryHitRect