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 文档错误。
返回代码 | 说明 |
---|---|
|
方法成功。 |
|
条目 不指向已识别的接口实现。 不支持 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 |