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


Метод IWICPalette::InitializePredefined (wincodec.h)

Инициализирует палитру одной из предварительно определенных палитр, заданных WICBitmapPaletteType , и при необходимости добавляет прозрачный цвет.

Синтаксис

HRESULT InitializePredefined(
  [in] WICBitmapPaletteType ePaletteType,
  [in] BOOL                 fAddTransparentColor
);

Параметры

[in] ePaletteType

Тип: WICBitmapPaletteType

Требуемый предварительно определенный тип палитры.

[in] fAddTransparentColor

Тип: BOOL

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

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

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Если в палитру добавляется прозрачный цвет, палитра больше не предопределена и возвращается как WICBitmapPaletteTypeCustom. Для палитр с менее чем 256 записями прозрачная запись добавляется в конец палитры (то есть 16-цветная палитра становится 17-цветной). Для палитр с 256 цветами прозрачная запись палитры заменит последнюю запись в предварительно определенной палитре.

Требования

Требование Значение
Минимальная версия клиента Windows XP с пакетом обновления 2 (SP2), Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header wincodec.h
Библиотека Windowscodecs.lib
DLL Windowscodecs.dll