IXpsOMGradientBrush：：SetTransformLookup 方法 (xpsobjectmodel.h)

  • 项目

设置要用于画笔的共享矩阵转换的查找键的名称。

键名称标识资源字典中的共享资源。

语法

HRESULT SetTransformLookup(
  [in] LPCWSTR key
);

参数

[in] key

要用于画笔的矩阵转换的查找键的名称。

返回值

该方法返回 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

另请参阅

IXpsOMGradientBrush

XML 纸张规范

XPS 文档错误