IViewObject2::GetExtent-Methode (oleidl.h)

Artikel
08/25/2023

Ruft die Größe ab, die das angegebene Ansichtsobjekt auf dem angegebenen Zielgerät gezeichnet wird.

Syntax

HRESULT GetExtent(
  [in]  DWORD          dwDrawAspect,
  [in]  LONG           lindex,
  [in]  DVTARGETDEVICE *ptd,
  [out] LPSIZEL        lpsizel
);

Parameter

[in] dwDrawAspect

Die angeforderte Ansicht des Objekts mit der relevanten Größe. Mögliche Werte werden der DVASPECT - und DVASPECT2-Enumeration entnommen. 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.

[in] lindex

Der teil des Objekts, der von Interesse ist. Derzeit ist der einzige mögliche Wert -1.

[in] ptd

Ein Zeiger auf die DVTARGETDEVICE-Struktur , die das Zielgerät definiert, für das die Größe des Objekts zurückgegeben werden soll.

[out] lpsizel

Ein Zeiger auf den Ort, an dem die Größe des Objekts zurückgegeben wird.

Rückgabewert

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

Rückgabecode	Beschreibung
OLE_E_BLANK	Ein entsprechender Cache ist nicht verfügbar.

Hinweise

Die von OLE bereitgestellte Implementierung von IViewObject2::GetExtent durchsucht den Cache nach der Größe des Ansichtsobjekts.

Die IOleObject::GetExtent-Methode in der IOleObject-Schnittstelle stellt einige der gleichen Informationen wie IViewObject2::GetExtent bereit.

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

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.

Hinweise für Anrufer

Um zu verhindern, dass das Objekt ausgeführt wird, wenn es noch nicht ausgeführt wird, können Sie IViewObject2::GetExtent anstelle von IOleObject::GetExtent aufrufen, um die Größe der zu zeichnenden Präsentation zu bestimmen.

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
DLL	Adhocreportingexcelclient.dll