Función wglGetLayerPaletteEntries (wingdi.h)

Artículo
03/13/2024

Recupera las entradas de la paleta de un plano de capa de índice de color determinado para un contexto de dispositivo especificado.

Sintaxis

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

Parámetros

unnamedParam1

Tipo: HDC

Contexto del dispositivo de una ventana cuyos planos de capa se van a describir.

unnamedParam2

Tipo: int

Superposición o plano subyacente. Los valores positivos de iLayerPlane identifican los planos de superposición, donde 1 es el primer plano de superposición sobre el plano principal, 2 es el segundo plano de superposición sobre el primer plano de superposición, etc. Los valores negativos identifican planos subyacentes, donde 1 es el primer plano subyacente bajo el plano principal, 2 es el segundo plano subyacente bajo el primer plano subyacente, etc. El número de planos superpuestos y subyacentes se proporciona en el miembro bReserved de la estructura PIXELFORMATDESCRIPTOR .

unnamedParam3

Tipo: int

Primera entrada de paleta que se va a recuperar.

unnamedParam4

Tipo: int

Número de entradas de paleta que se van a recuperar.

unnamedParam5

Tipo: COLORREF*

Matriz de estructuras que contienen valores de color RGB de paleta. La matriz debe contener al menos tantas estructuras como se especifique en cEntries.

Valor devuelto

Tipo: int

Si la función se realiza correctamente, el valor devuelto es el número de entradas que se establecieron en la paleta en el plano de capa especificado de la ventana.

Si se produce un error en la función o cuando no se selecciona ningún formato de píxel, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Cada plano de capa de índice de color de una ventana tiene una paleta con un tamaño de 2^n, donde n es el número de planos de bits en el plano de capa. No se puede modificar el índice transparente de una paleta.

Use la función wglRealizeLayerPalette para obtener la paleta de capas. Inicialmente, la paleta de capas solo contiene entradas para blanco.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wingdi.h
Library	Opengl32.lib
Archivo DLL	Opengl32.dll