Função GetSystemPaletteUse (wingdi.h)

A função GetSystemPaletteUse recupera o estado atual da paleta do sistema (físico) para o DC (contexto de dispositivo) especificado.

Sintaxe

UINT GetSystemPaletteUse(
  [in] HDC hdc
);

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

Retornar valor

Se a função for bem-sucedida, o valor retornado será o estado atual da paleta do sistema. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
SYSPAL_NOSTATIC A paleta do sistema não contém cores estáticas, exceto preto e branco.
SYSPAL_STATIC A paleta do sistema contém cores estáticas que não serão alteradas quando um aplicativo perceber sua paleta lógica.
SYSPAL_ERROR O contexto de dispositivo fornecido é inválido ou não dá suporte a uma paleta de cores.

Comentários

Por padrão, a paleta do sistema contém 20 cores estáticas que não são alteradas quando um aplicativo percebe sua paleta lógica. Um aplicativo pode obter acesso à maioria dessas cores chamando a função SetSystemPaletteUse .

O contexto do dispositivo identificado pelo parâmetro hdc deve representar um dispositivo que dê suporte a paletas de cores.

Um aplicativo pode determinar se um dispositivo dá suporte a paletas de cores 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

SetSystemPaletteUse