共用方式為


IXpsOMPageReference::GetPage 方法 (xpsobjectmodel.h)

取得包含頁面之 IXpsOMPage 介面的指標。

語法

HRESULT GetPage(
  [out, retval] IXpsOMPage **page
);

參數

[out, retval] page

頁面 IXpsOMPage 介面的指標。 如果尚未設定頁面,則會傳回 NULL 指標。

傳回值

方法會傳回 HRESULT。 可能的值包括下列數據表中的值,但不限於這些值。 如需此表格中未列出的 XPS 檔 API 傳回值的相關信息,請參閱 XPS 檔錯誤

傳回碼 描述
S_OK
此方法已成功。
E_POINTER
NULL
 

這個方法會呼叫 封裝 API。 如需封裝 API 傳回值的相關信息,請參閱 封裝錯誤

備註

如果尚未設定頁面,但包含頁面參考的 IXpsOMPackage 介面已從 XPS 套件載入,此方法將會載入並傳回頁面。 如果未設定頁面,且包含此頁面參考的 IXpsOMPackage 介面尚未從 XPS 套件載入,則會傳回 NULL 指標。

視頁面的內容而定,此呼叫可能需要一些時間才能傳回,也可能會造成檔樹狀結構中其他對象發生非預期的變更。 例如,如果頁面有遠端資源字典參考,遠端資源字典可能會遭到修改。

規格需求

需求
最低支援的用戶端 適用於 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

另請參閱

IXpsOMPageReference

IXpsOMPageReference::D iscardPage

IXpsOMPageReference::SetPage

封裝錯誤

XML Paper Specification

XPS 檔案錯誤