IXpsOMGradientStop：：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_NO_CUSTOM_OBJECTS	colorProfile 不指向已识别的接口实现。不支持 XPS 文档 API 接口的自定义实现。
XPS_E_UNEXPECTED_COLORPROFILE	colorProfile 在不需要颜色配置文件时包含颜色配置文件。仅当颜色类型为 XPS_COLOR_TYPE_CONTEXT时，才允许使用颜色配置文件。

仅当颜色类型为XPS_COLOR_TYPE_CONTEXT时，才需要颜色配置文件。

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