Compartilhar via


Função GetSystemPaletteEntries (wingdi.h)

A função GetSystemPaletteEntries recupera um intervalo de entradas de paleta da paleta do sistema associada ao DC (contexto de dispositivo) especificado.

Sintaxe

UINT GetSystemPaletteEntries(
  [in]  HDC            hdc,
  [in]  UINT           iStart,
  [in]  UINT           cEntries,
  [out] LPPALETTEENTRY pPalEntries
);

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

[in] iStart

A primeira entrada a ser recuperada da paleta do sistema.

[in] cEntries

O número de entradas a serem recuperadas da paleta do sistema.

[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 cEntries . Se esse parâmetro for NULL, a função retornará o número total de entradas na paleta.

Retornar valor

Se a função for bem-sucedida, o valor retornado será o número de entradas recuperadas da paleta.

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.

Requisitos

Requisito Valor
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

Confira também

Funções de cor

Visão geral de cores

Getdevicecaps

GetPaletteEntries

PALETTEENTRY