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 |