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


Функция wglSetLayerPaletteEntries (wingdi.h)

Задает записи палитры в заданной плоскости слоя цветового индекса для указанного контекста устройства.

Синтаксис

int wglSetLayerPaletteEntries(
  HDC            unnamedParam1,
  int            unnamedParam2,
  int            unnamedParam3,
  int            unnamedParam4,
  const COLORREF *unnamedParam5
);

Параметры

unnamedParam1

Тип: HDC

Контекст устройства окна, палитра слоев которого должна быть задана.

unnamedParam2

Тип: int

Плоскость перекрытия или подложки. Положительные значения iLayerPlane определяют плоскости наложения, где 1 — это первая плоскость наложения на main плоскости, 2 — вторая плоскость наложения над первой плоскостью наложения и т. д. Отрицательные значения определяют плоскости подложки, где 1 — это первая плоскость под уровнем main, 2 — вторая плоскость под первой плоскостью подложки и т. д. Количество плоскостей перекрытия и подложки задается в элементе bReserved структуры PIXELFORMATDESCRIPTOR .

unnamedParam3

Тип: int

Первая заданная запись палитры.

unnamedParam4

Тип: int

Количество записей палитры, которые необходимо задать.

unnamedParam5

Тип: const COLORREF*

Указатель на первый элемент массива структур cEntries , содержащих сведения о цвете RGB.

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

Тип: int

Если функция выполняется успешно, возвращаемое значение — это количество записей, которые были заданы в палитре в указанной плоскости слоя окна. Если функция завершается ошибкой или формат пикселей не выбран, возвращаемое значение равно нулю. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

Каждая плоскость цветового индекса в окне имеет палитру с размером 2^n, где n — количество битовых плоскостей в плоскости слоя. Нельзя изменить прозрачный индекс палитры.

Используйте функцию wglRealizeLayerPalette для реализации палитры слоев. Изначально палитра слоев содержит только записи для белого цвета.

Функция wglSetLayerPaletteEntries не задает записи палитры main плоскости. Чтобы обновить палитру main плоскости, используйте функции палитры GDI.

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header wingdi.h
Библиотека Opengl32.lib
DLL Opengl32.dll

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

LAYERPLANEDESCRIPTOR

OpenGL в Windows

PIXELFORMATDESCRIPTOR

Функции WGL

wglDescribeLayerPlane

wglGetLayerPaletteEntries

wglRealizeLayerPalette