IXpsOMPage::GetDictionary 方法 (xpsobjectmodel.h)
取得與此頁面相關聯之已解析 之 IXpsOMDictionary 介面的指標。
語法
HRESULT GetDictionary(
[out, retval] IXpsOMDictionary **resourceDictionary
);
參數
[out, retval] resourceDictionary
與此頁面相關聯的已解析 IXpsOMDictionary 介面指標。
此參數中傳回的值取決於最近呼叫哪一種方法來設定字典。
最近呼叫的方法 | resourceDictionary 中傳回的物件 |
---|---|
SetDictionaryLocal 所設定的本機字典資源。 | |
SetDictionaryResource 所設定字典資源中的共用字典。 | |
尚未呼叫 SetDictionaryLocal 或 SetDictionaryResource 。 | NULL 指標。 |
傳回值
方法會傳回 HRESULT。 可能的值包括但不限於下列數據表中的值。 如需此表格中未列出的 XPS 檔 API 傳回值的相關信息,請參閱 XPS 檔錯誤。
傳回碼 | 描述 |
---|---|
|
此方法已成功。 |
|
resourceDictionary 為 NULL。 |
|
SetStrokeBrushLookup 所設定的查閱索引鍵名稱會參考不是筆刷的物件。 |
|
找不到符合查閱值之索引鍵名稱的物件。
找不到符合 查閱中所傳遞值的索引鍵名稱的物件。 |
備註
不論字典是本機還是包含在遠端字典資源內,這個方法會傳回 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 |