wingdi.h


GetSystemPaletteEntries

La función GetSystemPaletteEntries recupera un rango de entradas de paleta desde la paleta del sistema que está asociada con el contexto de dispositivo especificado.

Sintaxis

UINT GetSystemPaletteEntries(
    HDC hdc,             // manipulador de contexto de dispositivo
    UINT iStartIndex,    // índice de la primera entrada a recuperar
    UINT nEntries,       // número de entradas a recuperar
    LPPALETTEENTRY lppe  // array para recibir las entradas de la paleta de sistema
   );

Parámetros

hdc: identifica el contexto de dispositivo.

iStartIndex: especifica la primera entrada a recuperar desde la paleta de sistema.

nEntries: especifica el número de entradas a recuperar desde la paleta de sistema.

lppe: puntero a un array de estructuras PALETTEENTRY para recibir las entradas de la paleta. El array debe contener al menos tantas estructuras como se especifique en el parámetro nEntries. Si este parámetro es NULL, la función devuelve el número de entradas total en la paleta.

Valor de retorno

Si la función tiene éxito, el valor de retorno es el número de entradas recuperadas desde la paleta.

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.