IViewObject2::GetExtent-Methode (oleidl.h)

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:

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

Anforderungen

Weitere Informationen

DVASPECT

DVASPECT2

IOleObject::GetExtent

IViewObject

IViewObject2