Função CreateSolidBrush (wingdi.h)

Artigo
03/04/2024

A função CreateSolidBrush cria um pincel lógico que tem a cor sólida especificada.

Sintaxe

HBRUSH CreateSolidBrush(
  [in] COLORREF color
);

Parâmetros

[in] color

A cor do pincel. Para criar um valor de cor COLORREF , use a macro RGB .

Retornar valor

Se a função for bem-sucedida, o valor retornado identificará um pincel lógico.

Se a função falhar, o valor retornado será NULL.

Comentários

Quando você não precisar mais do objeto HBRUSH , chame a função DeleteObject para excluí-lo.

Um pincel sólido é um bitmap que o sistema usa para pintar os interiores das formas preenchidas.

Depois que um aplicativo cria um pincel chamando CreateSolidBrush, ele pode selecionar esse pincel em qualquer contexto de dispositivo chamando a função SelectObject .

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.

ICM: Nenhum gerenciamento de cores é feito na criação do pincel. No entanto, o gerenciamento de cores é executado quando o pincel é selecionado em um contexto de dispositivo habilitado para ICM.

Exemplos

Para obter um exemplo, consulte Criando canetas e pincéis coloridos.

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