IXpsOMPage：：GetDictionary 方法 (xpsobjectmodel.h)
获取指向与此页关联的已解析 IXpsOMDictionary 接口的指针。
语法
HRESULT GetDictionary(
[out, retval] IXpsOMDictionary **resourceDictionary
);
参数
[out, retval] resourceDictionary
指向与此页关联的已解析 IXpsOMDictionary 接口的指针。
此参数中返回的值取决于最近调用的方法来设置字典。
| 最近调用的方法 | resourceDictionary 中返回的对象 |
|---|---|
| 由 SetDictionaryLocal 设置的本地字典资源。 | |
| 由 SetDictionaryResource 设置的字典资源中的共享字典。 | |
| 尚未调用 SetDictionaryLocal 和 SetDictionaryResource 。 | NULL 指针。 |
返回值
该方法返回 HRESULT。 可能的值包括但不限于后面的表中的值。 有关此表中未列出的 XPS 文档 API 返回值的信息，请参阅 XPS 文档错误。
| 返回代码 | 说明 |
|---|---|
|
方法成功。 |
|
resourceDictionary 为 NULL。 |
|
SetStrokeBrushLookup 设置的查找键名称引用不是画笔的对象。 |
|
找不到具有与查找值匹配的键名称的对象。
找不到具有与 查找中传递的值匹配的键名称的对象。 |
注解
无论字典是本地字典还是包含在远程字典资源中，此方法都返回 IXpsOMDictionary 接口指针。 GetOwner 确定字典是否为远程字典。
如果页面包含远程字典， GetDictionary 将反序列化该字典。 如果页面包含无效的远程字典， 则 GetDictionary 可能会返回反序列化错误代码。
将资源加载并分析到 XPS OM 后，此方法可能会返回适用于另一个资源的错误。 发生这种情况的原因是，加载资源时会分析所有关系。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 |UWP 应用] |
| 最低受支持的服务器 | Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 |UWP 应用] |
| 目标平台 | Windows |
| 标头 | xpsobjectmodel.h |