IXpsOMDictionary：：SetAt 方法 (xpsobjectmodel.h)
取代字典中指定位置的專案。
語法
HRESULT SetAt(
[in] UINT32 index,
[in] LPCWSTR key,
[in] IXpsOMShareable *entry
);
參數
[in] index
要取代專案之字典中以零起始的索引。
[in] key
要用於新專案的索引鍵。
索引鍵所參考的字串在字典中必須是唯一的。
[in] entry
IXpsOMShareable介面指標，將會取代索引所指定位置的目前內容。
字典不能包含重複的介面指標。 此參數必須包含尚未在字典中的介面指標。
傳回值
方法會傳回 HRESULT。 可能的值包括但不限於下列資料表中的值。 如需此表格中未列出的 XPS 檔 API 傳回值的相關資訊，請參閱 XPS 檔錯誤。
| 傳回碼 | 描述 |
|---|---|
|
此方法已成功。 |
|
entry 不會指向已辨識的介面實作。 不支援 XPS 檔 API 介面的自訂實作。 |
備註
在 索引所指定的位置，這個方法會釋放現有指標所參考的 IXpsOMShareable 介面，然後將它取代為傳入 專案的 介面指標，並將它指派傳入 索引鍵的索引鍵。
儲存在字典中的介面指標通常會指向衍生自IXpsOMShareable介面的介面，例如IXpsOMBrush和IXpsOMVisual。 若要判斷介面類別型，請呼叫 GetType 方法。
下圖說明 SetAt 方法如何變更字典。
規格需求
| 最低支援的用戶端 | 適用于 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 |