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 文档错误。

返回代码	说明
S_OK	方法成功。
XPS_E_NO_CUSTOM_OBJECTS	条目不指向已识别的接口实现。不支持 XPS 文档 API 接口的自定义实现。

在索引指定的位置，此方法释放现有指针引用的 IXpsOMShareable 接口，然后将其替换为 在条目 中传递的接口指针，并为其分配传入 键的键。

字典中存储的接口指针通常指向派生自 IXpsOMShareable 接口的接口，例如 IXpsOMBrush 和 IXpsOMVisual。若要确定接口类型，请调用 GetType 方法。

下图说明了 如何通过 SetAt 方法更改字典。


最低受支持的客户端	Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 \|UWP 应用]
最低受支持的服务器	Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 \|UWP 应用]
目标平台	Windows
标头	xpsobjectmodel.h