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 Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | xpsobjectmodel.h |