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 错误代码。
| 返回代码 | 说明 |
|---|---|
|
方法成功。 |
|
pageDimensions 为 NULL，或者 pageDimensions 引用的 XPS_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 |