Compartir a través de


Función GetPaletteEntries (wingdi.h)

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

Consulte también

Funciones de color

Introducción a los colores

GetDeviceCaps

GetSystemPaletteEntries

PALETTEENTRY

SetPaletteEntries