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

Статья
02/29/2024

Метод ImageAttributes::ClearRemapTable очищает таблицу цветового сопоставления для указанной категории.

Синтаксис

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

Параметры

[in, optional] type

Тип: ColorAdjustType

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

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

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

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

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

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

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

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

Требования

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