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 |