IOleObject::GetExtent-Methode (oleidl.h)

Artikel
03/04/2024

Ruft die aktuelle Anzeigegröße eines ausgeführten Objekts ab.

Syntax

HRESULT GetExtent(
  [in]  DWORD dwDrawAspect,
  [out] SIZEL *psizel
);

Parameter

[in] dwDrawAspect

Der Aspekt des Objekts, dessen Limit abgerufen werden soll; der Wert wird aus den Enumerationen DVASPECT und aus DVASPECT2 abgerufen. Beachten Sie, dass neuere Objekte und Container, die optimierte Zeichnungsschnittstellen unterstützen, die DVASPECT2-Enumerationswerte unterstützen. Ältere Objekte und Container, die keine optimierten Zeichnungsschnittstellen unterstützen, unterstützen möglicherweise keine DVASPECT2. Der gebräuchlichste Wert für diese Methode ist DVASPECT_CONTENT, der ein vollständiges Rendern des Objekts in seinem Container angibt.

[out] psizel

Ein Zeiger auf den Speicherort für die Rückgabe der Größe des Objekts.

Rückgabewert

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

Rückgabecode	Beschreibung
E_INVALIDARG	Der angegebene dwDrawAspect-Wert ist ungültig.

Hinweise

Ein Container ruft IOleObject::GetExtent für ein ausgeführtes Objekt auf, um seine aktuelle Anzeigegröße abzurufen. Wenn der Container diese Größe aufnehmen kann, wird er dies normalerweise tun, da das Objekt schließlich weiß, welche Größe es besser sein sollte als der Container. Ein Container führt diesen Aufruf normalerweise im Rahmen der Initialisierung eines Objekts aus.

Die von IOleObject::GetExtent zurückgegebene Anzeigegröße kann von der größe abweichen, die zuletzt von IOleObject::SetExtent festgelegt wurde, da die letztere Methode den Anzeigeraum des Objekts zum Zeitpunkt des Aufrufs der Methode vorschreibt, aber nicht notwendigerweise die native Größe des Objekts ändert, wie von der Anwendung bestimmt.

Wenn einer der neuen Aspekte in dwAspect angefordert wird, kann diese Methode entweder fehlschlagen oder das gleiche Rechteck wie für den DVASPECT_CONTENT-Aspekt zurückgeben.

Hinweis Diese Methode muss für alle neuen Aspekte in DVASPECT2 die gleiche Größe wie DVASPECT_CONTENT zurückgeben. IViewObject2::GetExtent muss dasselbe tun.

Hinweise für Anrufer

Da ein Container diesen Aufruf nur für ein ausgeführtes Objekt ausführen kann, muss der Container stattdessen IViewObject2::GetExtent aufrufen, wenn er die Anzeigegröße eines geladenen Objekts aus seinem Cache abrufen möchte.

Hinweise für Implementierer

Die Implementierung besteht darin, die sizel-Struktur mit der Höhe und Breite eines Objekts zu füllen.

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	oleidl.h