IViewObjectEx::GetRect-Methode (ocidl.h)

Artikel
08/25/2023

Ruft ein Rechteck ab, das einen angeforderten Zeichnungsaspekt beschreibt.

Syntax

HRESULT GetRect(
  [in]  DWORD   dwAspect,
  [out] LPRECTL pRect
);

Parameter

[in] dwAspect

Der angeforderte Zeichnungsaspekt.

[out] pRect

Ein Zeiger auf das Rechteck, das den angeforderten Zeichnungsaspekt beschreibt.

Rückgabewert

Diese Methode gibt S_OK bei Erfolg zurück. Weitere mögliche Rückgabewerte:

Rückgabecode	Beschreibung
DV_E_DVASPECT	Die -Methode unterstützt den angegebenen Aspekt nicht. Entweder unterstützt das Objekt den angeforderten Aspekt nicht oder der Aspekt ist nicht rechteckig.

Hinweise

Diese Methode gibt ein Rechteck zurück, das den angegebenen Zeichnungsaspekt beschreibt. Das zurückgegebene Rechteck befindet sich relativ zum Ursprung des Objekts in HIMETRIC-Einheiten . Das zurückgegebene Rechteck hängt wie folgt vom Zeichnungsaspekt ab.

Zeichnungsaspekt	BESCHREIBUNG
DVASPECT_CONTENT	Objekte sollten das umgebende Rechteck des gesamten Objekts zurückgeben. Die obere linke Ecke befindet sich am Ursprung des Objekts, und die Größe entspricht dem von IViewObject2::GetExtent zurückgegebenen Umfang.
DVASPECT_OPAQUE	Objekte mit einem rechteckigen undurchsichtigen Bereich sollten dieses Rechteck zurückgeben. Andere Sollten fehlschlagen und Fehlercode DV_E_DVASPECT zurückgeben. Wenn ein Rechteck zurückgegeben wird, wird es garantiert vollständig verschleiert, indem für diesen Aspekt IViewObject::D raw aufgerufen wird. Der Container sollte dieses Rechteck verwenden, um die undurchsichtigen Teile des Objekts auszuschneiden, bevor während des Durchgangs von hinten nach vorne ein Objekt dahinter gezeichnet wird. Wenn diese Methode bei einem Objekt mit einem nicht rechteckigen undurchsichtigen Bereich fehlschlägt, sollte der Container das gesamte Objekt im Vorder- und Rückseitenteil mit dem DVASPECT_CONTENT-Aspekt zeichnen.
DVASPECT_TRANSPARENT	Objekte sollten das Rechteck zurückgeben, das alle transparenten oder unregelmäßigen Teile abdeckt. Wenn das Objekt keine transparenten oder unregelmäßigen Teile aufweist, kann es DV_E_ASPECT zurückgeben. Ein Container kann dieses Rechteck verwenden, um zu bestimmen, ob es andere Objekte gibt, die die transparenten Teile eines bestimmten Objekts überlappen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ocidl.h

Weitere Informationen

IViewObjectEx

Freigeben über