Función SetPaletteEntries (wingdi.h)

Artículo
08/27/2023

La función SetPaletteEntries establece valores de color RGB (rojo, verde, azul) y marcas en un intervalo de entradas de una paleta lógica.

Sintaxis

UINT SetPaletteEntries(
  [in] HPALETTE           hpal,
  [in] UINT               iStart,
  [in] UINT               cEntries,
  [in] const PALETTEENTRY *pPalEntries
);

Parámetros

[in] hpal

Identificador de la paleta lógica.

[in] iStart

Primera entrada de paleta lógica que se va a establecer.

[in] cEntries

Número de entradas de paleta lógica que se van a establecer.

[in] pPalEntries

Puntero al primer miembro de una matriz de estructuras PALETTEENTRY que contienen los valores RGB y las marcas.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es el número de entradas que se establecieron en la paleta lógica.

Si la función no se realiza correctamente, el valor devuelto es cero.

Comentarios

Una aplicación puede determinar si un dispositivo admite operaciones de paleta llamando a la función GetDeviceCaps y especificando la constante RASTERCAPS.

Incluso si se ha seleccionado y realizado una paleta lógica, los cambios en la paleta no afectan a la paleta física en la superficie. Se debe llamar a RealizePalette de nuevo para establecer la nueva paleta lógica en la superficie.

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 (incluye Windows.h)
Library	Gdi32.lib
Archivo DLL	Gdi32.dll