IXpsOMVisual：：SetClipGeometryLookup 方法 (xpsobjectmodel.h)
设置资源字典中共享剪辑几何图形的查找键名称。
语法
HRESULT SetClipGeometryLookup(
[in] LPCWSTR key
);
参数
[in] key
字典中剪辑几何图形的查找键名称。 NULL 指针清除以前分配的密钥名称。
返回值
该方法返回 HRESULT。 可能的值包括但不限于后面的表中的值。 有关此表中未列出的 XPS 文档 API 返回值的信息，请参阅 XPS 文档错误。
| 返回代码 | 说明 |
|---|---|
|
方法成功。 |
|
根据 XML 纸张规范， 查找 的值不是有效的查找键字符串。 |
|
键中的查找 键 名称引用不是几何图形的对象。 |
|
找不到具有与在键中传递的值匹配的 键名称的对象。 |
注解
调用 SetClipGeometryLookup 后，将释放本地剪辑几何图形，GetClipGeometryLocal 在 clipGeometry 参数中返回 NULL 指针。 下表解释了此属性的本地值和查阅值之间的关系。
| 最近调用的方法 | GetClipGeometry 在 clipGeometry 中返回的对象 | GetClipGeometryLocal 在 clipGeometry 中返回的对象 | GetClipGeometryLookup 在键中返回的字符串 |
|---|---|---|---|
| 由 SetClipGeometryLocal 设置的本地剪辑几何图形。 | 由 SetClipGeometryLocal 设置的本地剪辑几何图形。 | NULL 指针。 | |
| SetClipGeometryLookup (此方法) | 检索到的共享剪辑几何图形，其查找键与 SetClipGeometryLookup 从资源目录设置的键匹配。 | NULL 指针。 | 由 SetClipGeometryLookup 设置的查找键。 |
| SetClipGeometryLookup 和 SetClipGeometryLocal 尚未调用。 | NULL 指针。 | NULL 指针。 | NULL 指针。 |
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 |UWP 应用] |
| 最低受支持的服务器 | Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 |UWP 应用] |
| 目标平台 | Windows |
| 标头 | xpsobjectmodel.h |