共用方式為


IXpsOMDictionary::Append 方法 (xpsobjectmodel.h)

IXpsOMShareable 介面及其 索引鍵 附加至字典結尾。

語法

HRESULT Append(
  [in] LPCWSTR         key,
  [in] IXpsOMShareable *entry
);

參數

[in] key

要用於這個專案的索引鍵。

索引鍵所參考的字串在字典中必須是唯一的。

[in] entry

要附加至字典之 IXpsOMShareable 介面的指標。

字典不能包含重複的介面指標。 此參數必須包含尚未在字典中的介面指標。

傳回值

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

傳回碼 描述
S_OK
此方法已成功。
XPS_E_NO_CUSTOM_OBJECTS
進入 不會指向已辨識的介面實作。 不支援 XPS 檔 API 介面的自訂實作。

備註

儲存在字典中的介面指標通常會指向衍生自IXpsOMShareable介面的介面,例如IXpsOMBrushIXpsOMVisual。 若要判斷介面類別型,請呼叫 IXpsOMShareable::GetType 方法。

下圖說明 Append 方法如何變更字典。

顯示 Append 如何將專案新增至字典的圖表

規格需求

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

另請參閱

IXpsOMBrush

IXpsOMDictionary

IXpsOMShareable

IXpsOMVisual

XML Paper Specification

XPS 檔錯誤