Função CreateSolidBrush (wingdi.h)

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

Confira também

Funções brush

Visão geral de pincéis

COLORREF

CreateDIBPatternBrush

Createdibpatternbrushpt

Createhatchbrush

Createpatternbrush

DeleteObject

GetSysColorBrush

RGB

Selectobject