Função GetPaletteEntries (wingdi.h)
A função GetPaletteEntries recupera um intervalo especificado de entradas de paleta da paleta lógica fornecida.
Sintaxe
UINT GetPaletteEntries(
[in] HPALETTE hpal,
[in] UINT iStart,
[in] UINT cEntries,
[out] LPPALETTEENTRY pPalEntries
);
Parâmetros
[in] hpal
Um identificador para a paleta lógica.
[in] iStart
A primeira entrada na paleta lógica a ser recuperada.
[in] cEntries
O número de entradas na paleta lógica a ser recuperada.
[out] pPalEntries
Um ponteiro para uma matriz de estruturas PALETTEENTRY para receber as entradas de paleta. A matriz deve conter pelo menos quantas estruturas forem especificadas pelo parâmetro nEntries .
Valor retornado
Se a função for bem-sucedida e o identificador para a paleta lógica for um ponteiro válido (não NULL), o valor retornado será o número de entradas recuperadas da paleta lógica. Se a função for bem-sucedida e o identificador para a paleta lógica for NULL, o valor retornado será o número de entradas na paleta fornecida.
Se a função falhar, o valor retornado será zero.
Comentários
Um aplicativo pode determinar se um dispositivo dá suporte a operações de paleta chamando a função GetDeviceCaps e especificando a constante RASTERCAPS.
Se o parâmetro nEntries especificar mais entradas do que existem na paleta, os membros restantes da estrutura PALETTEENTRY não serão alterados.
Requisitos
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | wingdi.h (inclua Windows.h) |
| Biblioteca | Gdi32.lib |
| DLL | Gdi32.dll |