Метод ImageAttributes::ClearThreshold (gdiplusimageattributes.h)
Метод ImageAttributes::ClearThreshold очищает пороговое значение для указанной категории.
Синтаксис
Status ClearThreshold(
[in, optional] ColorAdjustType type
);
Параметры
[in, optional] type
Тип: ColorAdjustType
Элемент перечисления ColorAdjustType , указывающий категорию, для которой очищается пороговое значение. Значение по умолчанию — ColorAdjustTypeDefault.
Возвращаемое значение
Тип: Состояние
В случае успешного выполнения метода возвращается ОК, который является элементом перечисления Status .
Если метод завершается сбоем, он возвращает один из других элементов перечисления Status .
Комментарии
Пороговое значение — это значение от 0 до 1, указывающее точку отсечения для каждого компонента цвета. Например, предположим, что пороговое значение равно 0,7 и предполагается, что вы отрисовываете цвет, красный, зеленый и синий компоненты 230, 50 и 220. Красный компонент 230 больше 0,7×255, поэтому красный компонент будет изменен на 255 (полная интенсивность). Зеленый компонент 50 меньше 0,7×255, поэтому зеленый компонент будет изменен на 0. Синий компонент 220 больше 0,7×255, поэтому синий компонент будет изменен на 255.
Объект ImageAttributes поддерживает параметры цвета и оттенков серого для пяти категорий корректировки: по умолчанию, растрового изображения, кисти, пера и текста. Например, можно указать пороговое значение для категории по умолчанию, другое пороговое значение для категории точечного изображения и другое пороговое значение для категории пера.
Параметры настройки цвета и оттенков серого по умолчанию применяются ко всем категориям, у которых нет собственных параметров настройки. Например, если вы никогда не указываете параметры корректировки для категории пера, то параметры по умолчанию применяются к категории пера.
Как только вы указываете параметр настройки цвета или оттенков серого для определенной категории, параметры настройки по умолчанию больше не применяются к этой категории. Например, предположим, что вы указали пороговое значение и гамма-значение для категории по умолчанию. Если задать пороговое значение для категории пера, вызвав ImageAttributes::SetThreshold, пороговое значение по умолчанию не будет применяться к ручкам. Если позже очистить порог пера, вызвав ImageAttributes::ClearThreshold, категория пера не будет отменить изменения порогового значения по умолчанию, а категория пера не будет иметь порогового значения. Аналогичным образом категория пера не будет отменить изменения гамма-значению по умолчанию; вместо этого категория пера не будет иметь гамма-значения.
Требования
| Минимальная версия клиента | Windows XP, Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | gdiplusimageattributes.h (включая Gdiplus.h) |
| Библиотека | Gdiplus.lib |
| DLL | Gdiplus.dll |