IXpsOMGradientBrush：：SetTransformLocal 方法 (xpsobjectmodel.h)

将 IXpsOMMatrixTransform 接口指针设置为要用于画笔的本地非共享矩阵转换。

语法

HRESULT SetTransformLocal(
  [in] IXpsOMMatrixTransform *transform
);

[in] transform

指向要用于画笔的本地非共享矩阵转换的 IXpsOMMatrixTransform 接口的指针。 NULL 指针释放之前设置的任何接口。

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

返回代码	说明
S_OK	方法成功。
XPS_E_NO_CUSTOM_OBJECTS	转换不指向已识别的接口实现。不支持 XPS 文档 API 接口的自定义实现。

调用 SetTransformLocal 后，将释放转换查找键，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