共用方式為


IXpsOMPage::GetDictionary 方法 (xpsobjectmodel.h)

取得與此頁面相關聯之已解析 之 IXpsOMDictionary 介面的指標。

語法

HRESULT GetDictionary(
  [out, retval] IXpsOMDictionary **resourceDictionary
);

參數

[out, retval] resourceDictionary

與此頁面相關聯的已解析 IXpsOMDictionary 介面指標。

此參數中傳回的值取決於最近呼叫哪一種方法來設定字典。

最近呼叫的方法 resourceDictionary 中傳回的物件

SetDictionaryLocal

SetDictionaryLocal 所設定的本機字典資源。

SetDictionaryResource

SetDictionaryResource 所設定字典資源中的共用字典。
尚未呼叫 SetDictionaryLocalSetDictionaryResource NULL 指標。

傳回值

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

傳回碼 描述
S_OK
此方法已成功。
E_POINTER
resourceDictionaryNULL
XPS_E_LOOKUP_INVALID_TYPE
SetStrokeBrushLookup 所設定的查閱索引鍵名稱會參考不是筆刷的物件。
XPS_E_LOOKUP_NOT_FOUND
找不到符合查閱值之索引鍵名稱的物件。

找不到符合 查閱中所傳遞值的索引鍵名稱的物件。

備註

不論字典是本機還是包含在遠端字典資源內,這個方法會傳回 IXpsOMDictionary 介面指標。 GetOwner 會判斷字典是否為遠端。

如果頁面包含遠端字典, GetDictionary 將會還原串行化字典。 如果頁面包含無效的遠端字典, GetDictionary 可能會傳回還原串行化錯誤碼。

將資源載入並剖析至 XPS OM 之後,此方法可能會傳回適用於另一個資源的錯誤。 這是因為載入資源時會剖析所有關聯性。

規格需求

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

另請參閱

IXpsOMDictionary

IXpsOMPage

XML Paper Specification

XPS 檔案錯誤