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
没有适当的缓存可用。

注解

OLE 提供的 IViewObject2::GetExtent 实现在缓存中搜索视图对象的大小。

IOleObject 接口中的 IOleObject::GetExtent 方法提供一些与 IViewObject2::GetExtent 相同的信息。

对于DVASPECT2中的所有新方面,此方法必须返回与 DVASPECT_CONTENT 相同的大小。 IOleObject::GetExtent 必须执行相同操作。

如果在 dwAspect 中请求了其中一个新方面,则此方法可能会失败或返回与DVASPECT_CONTENT方面相同的矩形。

给调用方的说明

若要防止对象在尚未运行的情况下运行,可以调用 IViewObject2::GetExtent 而不是 IOleObject::GetExtent 来确定要绘制的演示文稿的大小。

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 oleidl.h
DLL Adhocreportingexcelclient.dll

另请参阅

DVASPECT

DVASPECT2

IOleObject::GetExtent

IViewObject

IViewObject2