Função GetSysColorBrush (winuser.h)

Artigo
03/09/2024

A função GetSysColorBrush recupera um identificador que identifica um pincel lógico que corresponde ao índice de cores especificado.

Sintaxe

HBRUSH GetSysColorBrush(
  [in] int nIndex
);

Parâmetros

[in] nIndex

Um índice de cores. Esse valor corresponde à cor usada para pintar um dos elementos da janela. Consulte GetSysColor para obter valores de índice de cor do sistema.

Retornar valor

O valor retornado identificará um pincel lógico se o parâmetro nIndex tiver suporte na plataforma atual. Caso contrário, retornará NULL.

Comentários

Um pincel é um bitmap que o sistema usa para pintar os interiores das formas preenchidas. Um aplicativo pode recuperar as cores atuais do sistema chamando a função GetSysColor . Um aplicativo pode definir as cores atuais do sistema chamando a função SetSysColors .

Um aplicativo não deve registrar uma classe de janela para uma janela usando um pincel do sistema. Para registrar uma classe de janela com uma cor do sistema, consulte a documentação do membro hbrBackground das estruturas WNDCLASS ou WNDCLASSEX .

Pincéis de cores do sistema acompanham as alterações nas cores do sistema. Em outras palavras, quando o usuário altera uma cor do sistema, o pincel de cor do sistema associado muda automaticamente para a nova cor.

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.

Pincéis de cor do sistema são de propriedade do sistema, portanto, você não precisa destruí-los. Embora você não precise excluir o pincel lógico retornado por GetSysColorBrush , nenhum dano ocorre chamando DeleteObject.

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	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll
Conjunto de APIs	ext-ms-win-ntuser-gui-l1-1-1 (introduzido no Windows 8.1)