Função GetPaletteEntries (wingdi.h)

Artigo
08/27/2023

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