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

Статья
08/24/2023

Метод ImageAttributes::ClearOutputChannelColorProfile очищает параметр профиля цвета выходного канала для указанной категории.

Синтаксис

Status ClearOutputChannelColorProfile(
  [in, optional] ColorAdjustType type
);

Параметры

[in, optional] type

Тип: ColorAdjustType

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

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

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

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

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

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

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

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

Требования


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