Метод Bitmap::InitializePalette (gdiplusheaders.h)

Статья
02/01/2024

Метод Bitmap::InitializePalette инициализирует стандартную, оптимальную или пользовательскую цветовую палитру.

Синтаксис

Status InitializePalette(
  [in, out] ColorPalette *palette,
  [in]      PaletteType  palettetype,
  [in]      INT          optimalColors,
  [in]      BOOL         useTransparentColor,
  [in]      Bitmap       *bitmap
);

Параметры

[in, out] palette

Тип: ColorPalette*

Указатель на буфер, содержащий структуру ColorPalette , за которой следует массив значений ARGB . Необходимо задать элементы Flags и Count структуры ColorPalette . Элемент Entries структуры ColorPalette является массивом одного значения ARGB . Необходимо выделить память для структуры ColorPalette и для дополнительных значений ARGB в палитре. Например, если палитра содержит 36 значений ARGB , выделите буфер следующим образом: malloc(sizeof(ColorPalette) + 35*sizeof(ARGB)).

[in] palettetype

Тип: PaletteType

Элемент перечисления PaletteType , указывающий тип палитры. Палитра может иметь один из нескольких стандартных типов или настраиваемую палитру, которую вы определяете. Кроме того, метод Bitmap::InitializePalette может создать оптимальную палитру на основе указанного растрового изображения.

[in] optimalColors

Тип: INT

Целое число, указывающее количество цветов, которые вы хотите использовать в оптимальной палитре на основе указанного растрового изображения. Если этот параметр больше 0, параметр palettetype должен иметь значение PaletteTypeOptimal, а параметр bitmap должен указывать на объект Bitmap . Если вы создаете стандартную или пользовательскую палитру, а не оптимальную палитру, задайте для этого параметра значение 0.

[in] useTransparentColor

Тип: BOOL

Логическое значение, указывающее, следует ли включать прозрачный цвет в палитру. Задайте значение TRUE , чтобы включить прозрачный цвет; в противном случае — FALSE.

[in] bitmap

Тип: Растровое изображение*

Указатель на объект Bitmap , для которого будет создана оптимальная палитра. Если для palettetype задано значение PaletteTypeOptimal , а для optimalColors — положительное целое число, задайте для этого параметра адрес объекта Bitmap . В противном случае задайте для этого параметра значение NULL.

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

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

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

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

Требования


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

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

Bitmap

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