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


Метод ImageAttributes::SetColorMatrices (gdiplusimageattributes.h)

Метод ImageAttributes::SetColorMatrices задает матрицу цветовой коррекции и матрицу настройки оттенков серого для указанной категории.

Синтаксис

Status SetColorMatrices(
  [in]           const ColorMatrix *colorMatrix,
  [in]           const ColorMatrix *grayMatrix,
  [in, optional] ColorMatrixFlags  mode,
  [in, optional] ColorAdjustType   type
);

Параметры

[in] colorMatrix

Тип: const ColorMatrix*

Указатель на матрицу настройки цвета 5×5.

[in] grayMatrix

Тип: const ColorMatrix*

Указатель на матрицу корректировки оттенков серого 5×5.

[in, optional] mode

Тип: ColorMatrixFlags

Элемент перечисления ColorMatrixFlags , указывающий тип изображения и цвета, на которые будут влиять матрицы настройки цвета и оттенков серого. Значение по умолчанию — ColorMatrixFlagsDefault.

[in, optional] type

Тип: ColorAdjustType

Элемент перечисления ColorAdjustType , указывающий категорию, для которой заданы матрицы настройки цвета и оттенков серого. Значение по умолчанию — ColorAdjustTypeDefault.

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

Тип: Состояние

В случае успешного выполнения метода возвращается ОК, который является элементом перечисления Status .

Если метод завершается сбоем, он возвращает один из других элементов перечисления Status .

Комментарии

Объект ImageAttributes поддерживает параметры цвета и оттенков серого для пяти категорий корректировки: по умолчанию, растрового изображения, кисти, пера и текста. Например, можно указать матрицы корректировки для категории по умолчанию, различные матрицы корректировки для категории битового рисунка и другие матрицы корректировки для категории пера.

Параметры настройки цвета и оттенков серого по умолчанию применяются ко всем категориям, у которых нет собственных параметров настройки. Например, если вы никогда не указываете параметры корректировки для категории пера, то параметры по умолчанию применяются к категории пера.

Как только вы указываете параметр настройки цвета или оттенков серого для определенной категории, параметры настройки по умолчанию больше не применяются к этой категории. Например, предположим, что вы указали коллекцию параметров корректировки для категории по умолчанию. Если задать матрицы настройки цвета и оттенков серого для категории пера путем передачи ColorAdjustTypePen в метод ImageAttributes::SetColorMatrices , ни один из параметров настройки по умолчанию не будет применяться к ручкам.

Требования

Требование Значение
Минимальная версия клиента Windows XP, Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header gdiplusimageattributes.h (включая Gdiplus.h)
Библиотека Gdiplus.lib
DLL Gdiplus.dll

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

Bitmap

Цвет

Coloradjusttype

ColorMatrix

Изображение

Атрибуты ImageAttributes

ImageAttributes::ClearColorMatrices

ImageAttributes::ClearColorMatrix

ImageAttributes::SetColorMatrix

ImageAttributes::SetToIdentity

Метафайл

Перекрашивание