Compartilhar via


Função GetSysColor (winuser.h)

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
Uma janela com texto usando a cor do texto da janela. COLOR_WINDOWTEXT
Uma janela com texto de hiperlink usando a cor de luz quente. COLOR_HOTLIGHT
Uma janela com texto inativo usando a cor de texto cinza. COLOR_GRAYTEXT
Uma janela com texto usando a cor do texto de realce na cor de realce. COLOR_HIGHLIGHTTEXT + REALCE
Uma janela com um botão usando a cor do rosto 3d e o texto do botão usando a cor do texto do botão. 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

Confira também

Createsolidbrush

GetSysColorBrush

SetSysColors

SystemParametersInfo