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

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

  • Статья

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

Синтаксис

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_NO_CUSTOM_OBJECTS
 colorProfile не указывает на реализацию распознанного интерфейса. Пользовательская реализация интерфейсов API документов XPS не поддерживается.
XPS_E_UNEXPECTED_COLORPROFILE
 ColorProfile содержал цветной профиль, если он не ожидался. Цветовой профиль разрешен только в том случае, если тип цвета XPS_COLOR_TYPE_CONTEXT.

Комментарии

Цветовой профиль требуется только в том случае, если тип цветаXPS_COLOR_TYPE_CONTEXT.

Требования

Требование Значение
Минимальная версия клиента 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

IXpsOMGradientStop

XPS

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

XPS_COLOR