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