Função GetSysColor (winuser.h)

Artigo
08/27/2023

Recupera a cor atual do elemento de exibição especificado. Elementos de exibição são as partes de uma janela e a exibição que aparecem na tela de exibição do sistema.

Sintaxe

DWORD GetSysColor(
  [in] int nIndex
);

Parâmetros

[in] nIndex

Tipo: int

O elemento de exibição cuja cor deve ser recuperada. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
COLOR_3DDKSHADOW 21	Sombra escura para elementos de exibição tridimensionais. Windows 10 ou superior: Não há suporte para esse valor.
COLOR_3DFACE 15	Cor da face para elementos de exibição tridimensionais e para planos de fundo da caixa de diálogo.
COLOR_3DHIGHLIGHT 20	Realce a cor dos elementos de exibição tridimensionais (para bordas voltadas para a fonte de luz).) Windows 10 ou superior: Não há suporte para esse valor.
COLOR_3DHILIGHT 20	Realce a cor dos elementos de exibição tridimensionais (para bordas voltadas para a fonte de luz).) Windows 10 ou superior: Não há suporte para esse valor.
COLOR_3DLIGHT 22	Cor clara para elementos de exibição tridimensionais (para bordas voltadas para a fonte de luz).) Windows 10 ou superior: Não há suporte para esse valor.
COLOR_3DSHADOW 16	Cor da sombra para elementos de exibição tridimensionais (para bordas voltadas para longe da fonte de luz). Windows 10 ou superior: Não há suporte para esse valor.
COLOR_ACTIVEBORDER 10	Borda da janela ativa. Windows 10 ou superior: Não há suporte para esse valor.
COLOR_ACTIVECAPTION 2	Barra de título da janela ativa. A cor de primeiro plano associada é COLOR_CAPTIONTEXT. Especifica a cor do lado esquerdo no gradiente de cor da barra de título de uma janela ativa se o efeito de gradiente estiver habilitado. Windows 10 ou superior: Não há suporte para esse valor.
COLOR_APPWORKSPACE 12	Cor da tela de fundo de vários aplicativos de interface de documento (MDI). Windows 10 ou superior: Não há suporte para esse valor.
COLOR_BACKGROUND 1	Desktop. Windows 10 ou superior: Não há suporte para esse valor.
COLOR_BTNFACE 15	Cor da face para elementos de exibição tridimensionais e para planos de fundo da caixa de diálogo. A cor de primeiro plano associada é COLOR_BTNTEXT. Windows 10 ou superior: Não há suporte para esse valor.
COLOR_BTNHIGHLIGHT 20	Realce a cor dos elementos de exibição tridimensionais (para bordas voltadas para a fonte de luz).) Windows 10 ou superior: Não há suporte para esse valor.
COLOR_BTNHILIGHT 20	Realce a cor dos elementos de exibição tridimensionais (para bordas voltadas para a fonte de luz).) Windows 10 ou superior: Não há suporte para esse valor.
COLOR_BTNSHADOW 16	Cor da sombra para elementos de exibição tridimensionais (para bordas voltadas para longe da fonte de luz). Windows 10 ou superior: Não há suporte para esse valor.
COLOR_BTNTEXT 18	Texto nos botões de ação. A cor da tela de fundo associada é COLOR_BTNFACE.
COLOR_CAPTIONTEXT 9	Texto em legenda, caixa de tamanho e caixa de seta da barra de rolagem. A cor da tela de fundo associada é COLOR_ACTIVECAPTION. Windows 10 ou superior: Não há suporte para esse valor.
COLOR_DESKTOP 1	Desktop. Windows 10 ou superior: Não há suporte para esse valor.
COLOR_GRADIENTACTIVECAPTION 27	Cor do lado direito no gradiente de cores da barra de título de uma janela ativa. COLOR_ACTIVECAPTION especifica a cor do lado esquerdo. Use SPI_GETGRADIENTCAPTIONS com a função SystemParametersInfo para determinar se o efeito de gradiente está habilitado. Windows 10 ou superior: Não há suporte para esse valor.
COLOR_GRADIENTINACTIVECAPTION 28	Cor do lado direito no gradiente de cor da barra de título de uma janela inativa. COLOR_INACTIVECAPTION especifica a cor do lado esquerdo. Windows 10 ou superior: Não há suporte para esse valor.
COLOR_GRAYTEXT 17	Texto cinza (desabilitado). Essa cor será definida como 0 se o driver de exibição atual não der suporte a uma cor cinza sólida.
COLOR_HIGHLIGHT 13	Itens selecionados em um controle . A cor de primeiro plano associada é COLOR_HIGHLIGHTTEXT.
COLOR_HIGHLIGHTTEXT 14	Texto de itens selecionados em um controle . A cor da tela de fundo associada é COLOR_HIGHLIGHT.
COLOR_HOTLIGHT 26	Cor de um hiperlink ou item com acompanhamento frequente. A cor da tela de fundo associada é COLOR_WINDOW.
COLOR_INACTIVEBORDER 11	Borda da janela inativa. Windows 10 ou superior: Não há suporte para esse valor.
COLOR_INACTIVECAPTION 3	Janela inativa legenda. A cor de primeiro plano associada é COLOR_INACTIVECAPTIONTEXT. Especifica a cor do lado esquerdo no gradiente de cor da barra de título de uma janela inativa se o efeito de gradiente estiver habilitado. Windows 10 ou superior: Não há suporte para esse valor.
COLOR_INACTIVECAPTIONTEXT 19	Cor do texto em um legenda inativo. A cor da tela de fundo associada é COLOR_INACTIVECAPTION. Windows 10 ou superior: Não há suporte para esse valor.
COLOR_INFOBK 24	Cor da tela de fundo para controles de dica de ferramenta. A cor de primeiro plano associada é COLOR_INFOTEXT. Windows 10 ou superior: Não há suporte para esse valor.
COLOR_INFOTEXT 23	Cor do texto para controles de dica de ferramenta. A cor da tela de fundo associada é COLOR_INFOBK. Windows 10 ou superior: Não há suporte para esse valor.
COLOR_MENU 4	Plano de fundo do menu. A cor de primeiro plano associada é COLOR_MENUTEXT. Windows 10 ou superior: Não há suporte para esse valor.
COLOR_MENUHILIGHT 29	A cor usada para realçar itens de menu quando o menu aparece como um menu simples (consulte SystemParametersInfo). O item de menu realçado é descrito com COLOR_HIGHLIGHT. Windows 2000, Windows 10 ou superior: Não há suporte para esse valor.
COLOR_MENUBAR 30	A cor da tela de fundo da barra de menus quando os menus aparecem como menus simples (consulte SystemParametersInfo). No entanto, COLOR_MENU continua especificando a cor da tela de fundo do pop-up do menu. Windows 2000, Windows 10 ou superior: Não há suporte para esse valor.
COLOR_MENUTEXT 7	Texto nos menus. A cor da tela de fundo associada é COLOR_MENU. Windows 10 ou superior: Não há suporte para esse valor.
COLOR_SCROLLBAR 0	Área cinza da barra de rolagem. Windows 10 ou superior: Não há suporte para esse valor.
COLOR_WINDOW 5	Tela de fundo da janela. As cores de primeiro plano associadas são COLOR_WINDOWTEXT e COLOR_HOTLITE.
COLOR_WINDOWFRAME 6	Quadro de janela. Windows 10 ou superior: Não há suporte para esse valor.
COLOR_WINDOWTEXT 8	Texto nas janelas. A cor da tela de fundo associada é COLOR_WINDOW.

Valor retornado

Tipo: DWORD

A função retorna o valor de cor vermelho, verde, azul (RGB) do elemento fornecido.

Se o parâmetro nIndex estiver fora do intervalo, o valor retornado será zero. Como zero também é um valor RGB válido, você não pode usar GetSysColor para determinar se há suporte para uma cor do sistema na plataforma atual. Em vez disso, use a função GetSysColorBrush , que retornará NULL se não houver suporte para a cor.

Comentários

Para exibir o componente do valor RGB, use as macros GetRValue, GetGValue e GetBValue .

As cores do sistema para telas monocromáticas geralmente são interpretadas como tons de cinza.

Para pintar com um pincel de cor do sistema, um aplicativo deve usar GetSysColorBrush(nIndex), em vez de CreateSolidBrush(GetSysColor(nIndex)), porque GetSysColorBrush retorna um pincel armazenado em cache, em vez de alocar um novo.

Color é um elemento visual importante da maioria das interfaces do usuário. Para obter diretrizes sobre como usar cores em seus aplicativos, consulte Cor – Win32 e Cor no Windows 11.

Cores do sistema windows 10/11

Esta tabela mostra os valores com suporte no Windows 10 e Windows 11 com valores de cor do tema de contraste aquático Windows 11.

Amostra de cores	Descrição
	COLOR_WINDOW Tela de fundo de páginas, painéis, pop-ups e janelas. Emparelhar com COLOR_WINDOWTEXT
	COLOR_WINDOWTEXT Títulos, cópia do corpo, listas, texto de espaço reservado, bordas do aplicativo e da janela, qualquer interface do usuário que não possa ser interagida. Emparelhar com COLOR_WINDOW
	COLOR_HOTLIGHTHiperlinks. Emparelhar com COLOR_WINDOW
	COLOR_GRAYTEXTInterface do usuário inativa (desabilitada). Emparelhar com COLOR_WINDOW
	COLOR_HIGHLIGHTTEXTCor de primeiro plano para texto ou interface do usuário que está selecionado, interagiu com (focalizar, pressionar) ou em andamento. Emparelhar com COLOR_HIGHLIGHT
	COLOR_HIGHLIGHTCor da tela de fundo ou de destaque da interface do usuário que está selecionada, interagiu com (focalizar, pressionar) ou em andamento. Emparelhar com COLOR_HIGHLIGHTTEXT
	COLOR_BTNTEXTCor de primeiro plano para botões e qualquer interface do usuário com a qual possa interagir. Emparelhar com COLOR_3DFACE
	COLOR_3DFACECor da tela de fundo para botões e qualquer interface do usuário com a qual possa interagir. Emparelhar com COLOR_BTNTEXT

Essas imagens mostram como as cores aparecem quando usadas em um conjunto de planos de fundo como COLOR_WINDOW.

Exemplo	Valores
	COLOR_WINDOWTEXT
	COLOR_HOTLIGHT
	COLOR_GRAYTEXT
	COLOR_HIGHLIGHTTEXT + REALCE
	COLOR_BTNTEXT + COLOR_3DFACE

Exemplos

Para obter um exemplo, consulte SetSysColors.

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	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll