IXpsOMPageReference::SetAdvisoryPageDimensions 方法 (xpsobjectmodel.h)

设置页面的建议尺寸。

语法

HRESULT SetAdvisoryPageDimensions(
  [in] const XPS_SIZE *pageDimensions
);

参数

[in] pageDimensions

要为页面设置的建议尺寸。

高度宽度成员的值必须为 –1.0 或大于或等于 +1.0 的值。

大小以 XPS 单位描述。 每英寸有 96 个 XPS 单位。 例如,8.5“ x 11.0” 页的尺寸为 816 x 1,056 XPS 单位。

返回值

如果该方法成功,则返回S_OK;否则,它将返回 HRESULT 错误代码。

返回代码 说明
S_OK
方法成功。
E_POINTER
pageDimensionsNULL,或者 pageDimensions 引用的 XPS_SIZE 结构中的字段包含无效的值。
XPS_E_INVALID_PAGE_SIZE
pageDimensions 中描述的公告页大小无效。 pageDimensions的高度和宽度成员的值必须是 –1.0 或大于或等于 +1.0 的值。

注解

pageDimensions 引用的 XPS_SIZE 结构的高度宽度成员的值必须大于或等于 +1.0(如果要设置这些字段的值),否则必须具有 –1.0。 例如,如果仅针对页面宽度设置建议维度, 则 pageDimensions.width 将具有所需的值, pageDimensions.height 的值为 –1.0。

要求

要求
最低受支持的客户端 Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 |UWP 应用]
目标平台 Windows
标头 xpsobjectmodel.h

另请参阅

IXpsOMPageReference

XML 纸张规范

XPS_SIZE