IXpsOMSolidColorBrush：：SetColor 方法 (xpsobjectmodel.h)

  • 项目

设置画笔的颜色值和颜色配置文件。

语法

HRESULT SetColor(
  [in] const XPS_COLOR            *color,
  [in] IXpsOMColorProfileResource *colorProfile
);

参数

[in] color

画笔的颜色值。

如果此参数中传递的 XPS_COLOR 结构中的 colorType 字段的值XPS_COLOR_TYPE_CONTEXT，则必须在 colorProfile 参数中提供有效的颜色配置文件。

[in] colorProfile

要与颜色一起使用 的颜色配置文件。

当在 color 参数中传递的 XPS_COLOR 结构中的 colorType 字段的值XPS_COLOR_TYPE_CONTEXT时，需要颜色配置文件。 如果未XPS_COLOR_TYPE_CONTEXTcolorType 字段的值，则必须将此参数设置为 NULL。

返回值

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

返回代码 说明
S_OK
 方法成功。
E_POINTER
 color 为 NULL。
XPS_E_MISSING_COLORPROFILE
 colorProfile 在需要颜色配置文件时为 NULL 。 当颜色类型 为XPS_COLOR_TYPE_CONTEXT时，需要颜色配置文件。
XPS_E_UNEXPECTED_COLORPROFILE
 colorProfile 在预期没有颜色配置文件时具有颜色配置文件。 仅当颜色类型为 XPS_COLOR_TYPE_CONTEXT时，才允许使用颜色配置文件。
XPS_E_NO_CUSTOM_OBJECTS
 colorProfile 不指向已识别的接口实现。 不支持 XPS 文档 API 接口的自定义实现。

要求

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

另请参阅

IXpsOMColorProfileResource

IXpsOMSolidColorBrush

XML 纸张规范

XPS 文档错误

XPS_COLOR