IXpsOMGradientBrush::GetTransform 方法 (xpsobjectmodel.h)

获取指向 IXpsOMMatrixTransform 接口的指针,该接口包含画笔的已解析矩阵转换。

语法

HRESULT GetTransform(
  [out, retval] IXpsOMMatrixTransform **transform
);

参数

[out, retval] transform

指向 IXpsOMMatrixTransform 接口的指针,该接口包含画笔的已解析矩阵转换。 如果尚未设置转换,则返回 NULL 指针。

此参数中返回的值取决于最近调用的方法来设置转换。

最近调用的方法 在转换中返回的对象

SetTransformLocal

由 SetTransformLocal 设置的本地转换。

SetTransformLookup

从资源目录中检索的共享转换,其中包含与 SetTransformLookup 设置的键匹配的查找键。
尚未调用 SetTransformLocal 和 SetTransformLookup 。 NULL 指针。

返回值

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

返回代码 说明
S_OK
方法成功。
E_POINTER
transform 为 NULL。
XPS_E_LOOKUP_INVALID_TYPE
SetStrokeBrushLookup 设置的查找键名称引用不是画笔的对象。
XPS_E_LOOKUP_NOT_FOUND
找不到与查阅值匹配的键名称的对象。

找不到与 查找中传递的值匹配的键名称的对象。

注解

转换确定渐变的转换方式。 最终在图像中呈现的渐变的可见部分由使用渐变画笔的路径、笔划或字形决定。

要求

要求 值
最低受支持的客户端 Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 |UWP 应用]
目标平台 Windows
标头 xpsobjectmodel.h

另请参阅

IXpsOMGradientBrush

IXpsOMMatrixTransform

XML 纸张规范

XPS 文档错误