IXpsOMTileBrush：：SetTransformLookup 方法 (xpsobjectmodel.h)

设置将用作此画笔转换的共享矩阵转换的查找键名称。由查找键引用的共享矩阵转换存储在资源字典中。

语法

HRESULT SetTransformLookup(
  [in] LPCWSTR key
);

参数

[in] key

一个字符串变量，其中包含资源字典中共享矩阵转换的查找键名称。 如果已设置查找键， 则 NULL 指针将清除它。

返回值

该方法返回 HRESULT。 可能的值包括但不限于后面的表中的值。 有关此表中未列出的 XPS 文档 API 返回值的信息，请参阅 XPS 文档错误。

返回代码	说明
S_OK	方法成功。
XPS_E_INVALID_RESOURCE_KEY	根据 XML 纸张规范， 查找 的值不是有效的查找键字符串。
XPS_E_INVALID_LOOKUP_TYPE	键中的查找 键 名称引用不是几何图形的对象。
XPS_E_LOOKUP_NOT_FOUND	找不到具有与在键中传递的值匹配的 键名称的对象。

注解

在使用图块画笔的路径、笔划或字形中呈现画笔图像之前，将应用转换。 磁贴画笔只有一个转换，可以是本地转换，也可以是远程转换。

调用 SetTransformLookup 后，本地转换将释放，GetTransformLocal 在转换参数中返回 NULL 指针。 下表解释了此属性的本地值和查阅值之间的关系。

最近调用的方法	GetTransform 在转换中返回的对象	GetTransformLocal 在转换中返回的对象	GetTransformLookup 在键中返回的字符串
SetTransformLocal	由 SetTransformLocal 设置的转换。	由 SetTransformLocal 设置的转换。	NULL 指针。
SetTransformLookup (此方法)	使用与 SetTransformLookup 设置的键匹配的查找键从资源目录检索的转换。	NULL 指针。	由 SetTransformLookup 设置的查找键。
尚未调用 SetTransformLocal 和 SetTransformLookup 。	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

另请参阅

IXpsOMTileBrush

XML 纸张规范

XPS 文档错误