Función GetPaletteEntries (wingdi.h)

Artículo
08/27/2023

La función GetPaletteEntries recupera un intervalo especificado de entradas de paleta de la paleta especificada de la paleta lógica especificada.

Sintaxis

UINT GetPaletteEntries(
  [in]  HPALETTE       hpal,
  [in]  UINT           iStart,
  [in]  UINT           cEntries,
  [out] LPPALETTEENTRY pPalEntries
);

Parámetros

[in] hpal

Identificador de la paleta lógica.

[in] iStart

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

[in] cEntries

Número de entradas de la paleta lógica que se va a recuperar.

[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 nEntries .

Valor devuelto

Si la función se ejecuta correctamente y el identificador de la paleta lógica es un puntero válido (no NULL), el valor devuelto es el número de entradas recuperadas de la paleta lógica. Si la función se realiza correctamente y controla la paleta lógica es NULL, el valor devuelto es el número de entradas de la paleta especificada.

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.

Si el parámetro nEntries especifica más entradas de las que existen en la paleta, no se modifican los miembros restantes de la estructura PALETTEENTRY .

Requisitos


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