wingdi.h


GetPaletteEntries

La función GetPaletteEntries recupera un rango especificado de entradas de paleta de la paleta lógica dada.

Sintaxis

UINT GetPaletteEntries(
    HPALETTE hpal,       // manipulador de paleta de colores lógica
    UINT iStartIndex,    // primera entrada a recuperar
    UINT nEntries,       // número de entradas a recuperar
    LPPALETTEENTRY lppe  // dirección del array que recibirá las entradas
   );

Parámetros

hpal: identifica una paleta de colores lógica.

iStartIndex: especifica la primera entrada de la paleta lógica a recuperar.

nEntries: especifica el número de entradas de la paleta lógica a recuperar.

lppe: puntero a un array de estructuras PALETTEENTRY para recibir las entradas de paleta. El array debe contener al menos tantas estructuras como se especifica en el parámetro nEntries.

Valor de retorno

Si la función tiene éxito y el parámetro lppe es un puntero válido (no NULL), el valor de retorno es el número de entradas recuperadas desde la paleta lógica. Si la función tiene éxito y el parámetro lppe es NULL, el valor de retorno es el número de entradas en la paleta dada.

Si la función falla, el valor de retorno es cero. Para obtener mayor información sobre el error, llamar a GetLastError.

Observaciones

Para determinar si un dispositivo soporta operaciones de paleta se puede usar la función GetDeviceCaps, especificando la constante RASTERCAPS.

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