IViewObject2::GetExtent 方法 (oleidl.h)

擷取指定之檢視物件將在指定的目標裝置上繪製的大小。

語法

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

參數

[in] dwDrawAspect

具有想要大小之物件的要求檢視。 可能的值取自 DVASPECTDVASPECT2 列舉。 請注意,支援優化繪圖介面的新物件和容器支援 DVASPECT2 列舉值。 不支援優化繪圖介面的舊物件和容器可能不支援 DVASPECT2

[in] lindex

感興趣的物件部分。 目前唯一的可能值為 -1。

[in] ptd

DVTARGETDEVICE結構的指標,定義應該傳回物件大小的目標裝置。

[out] lpsizel

傳回物件大小的指標。

傳回值

此方法會在成功時傳回S_OK。 其他可能的傳回值包括下列專案。

傳回碼 說明
OLE_E_BLANK
無法使用適當的快取。

備註

IViewObject2::GetExtent的 OLE 提供的實作會搜尋快取中檢視物件的大小。

IOleObject介面中的IOleObject::GetExtent方法提供一些與IViewObject2::GetExtent相同的資訊。

這個方法必須針對 DVASPECT2中的所有新層面傳回與DVASPECT_CONTENT相同的大小。 IOleObject::GetExtent 必須執行相同的動作。

如果在 dwAspect中要求其中一個新層面,這個方法可能會失敗或傳回與DVASPECT_CONTENT層面相同的矩形。

呼叫端的附注

若要防止物件在執行中,如果尚未執行,您可以呼叫 IViewObject2::GetExtent ,而不是 IOleObject::GetExtent 來判斷要繪製之簡報的大小。

規格需求

   
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 Windows
標頭 oleidl.h
DLL Adhocreportingexcelclient.dll

另請參閱

DVASPECT

DVASPECT2

IOleObject::GetExtent

IViewObject

IViewObject2