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 |