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
colorNULL
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