Función GetSystemPaletteEntries (wingdi.h)

La función GetSystemPaletteEntries recupera un intervalo de entradas de paleta de la paleta del sistema asociada al contexto de dispositivo (DC) especificado.

Sintaxis

UINT GetSystemPaletteEntries(
  [in]  HDC            hdc,
  [in]  UINT           iStart,
  [in]  UINT           cEntries,
  [out] LPPALETTEENTRY pPalEntries
);

Parámetros

[in] hdc

Identificador del contexto del dispositivo.

[in] iStart

Primera entrada que se va a recuperar de la paleta del sistema.

[in] cEntries

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

[out] pPalEntries

Puntero a una matriz de estructuras PALETTEENTRY para recibir las entradas de la paleta. La matriz debe contener al menos tantas estructuras como especifique el parámetro cEntries . Si este parámetro es NULL, la función devuelve el número total de entradas de la paleta.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es el número de entradas recuperadas de la paleta.

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.

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

Consulte también

Funciones de color

Introducción a los colores

GetDeviceCaps

GetPaletteEntries

PALETTEENTRY