Метод IXpsOMSolidColorBrush::SetColor (xpsobjectmodel.h)

Статья
12/22/2023

Задает значение цвета и цветной профиль кисти.

Синтаксис

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

Параметры

[in] color

Значение цвета кисти.

Если значение поля colorType в структуре XPS_COLOR , передаваемой в этом параметре, XPS_COLOR_TYPE_CONTEXT, в параметре colorProfile должен быть указан допустимый цветной профиль.

[in] colorProfile

Цветной профиль, используемый с цветом.

Цветовой профиль является обязательным, если значение поля colorType в структуре XPS_COLOR, передаваемой в параметре color, XPS_COLOR_TYPE_CONTEXT. Если значение поля colorType не XPS_COLOR_TYPE_CONTEXT, для этого параметра необходимо задать значение NULL.

Возвращаемое значение

Метод возвращает HRESULT. Возможные значения включают, помимо прочего, значения в следующей таблице. Сведения о возвращаемых значениях API документов XPS, не перечисленных в этой таблице, см. в статье Ошибки документа 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 не указывает на реализацию распознанного интерфейса. Пользовательская реализация интерфейсов API документов XPS не поддерживается.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7, Windows Vista с пакетом обновления 2 (SP2) и обновлением платформы для Windows Vista [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	xpsobjectmodel.h

См. также раздел

IXpsOMColorProfileResource

IXpsOMSolidColorBrush

XPS

Ошибки документа XPS

XPS_COLOR

Поделиться через