Função SetDCBrushColor (wingdi.h)
A função SetDCBrushColor define a cor do pincel do DC (contexto do dispositivo) atual como o valor de cor especificado. Se o dispositivo não puder representar o valor de cor especificado, a cor será definida como a cor física mais próxima.
Sintaxe
COLORREF SetDCBrushColor(
[in] HDC hdc,
[in] COLORREF color
);
Parâmetros
[in] hdc
Um identificador para o controlador de domínio.
[in] color
A nova cor do pincel.
Retornar valor
Se a função for bem-sucedida, o valor retornado especificará a cor do pincel dc anterior como um valor COLORREF .
Se a função falhar, o valor de retorno será CLR_INVALID.
Comentários
Quando o DC_BRUSH de ações for selecionado em um DC, todos os desenhos subsequentes serão feitos usando a cor do pincel dc até que o pincel de estoque seja desmarcado. A cor de DC_BRUSH padrão é BRANCO.
A função retorna a cor DC_BRUSH anterior, mesmo que o pincel de estoque DC_BRUSH não esteja selecionado no DC: no entanto, isso não será usado em operações de desenho até que a DC_BRUSH de ações seja selecionada no DC.
A função GetStockObject com um argumento de DC_BRUSH ou DC_PEN pode ser usada de forma intercambiável com as funções SetDCPenColor e SetDCBrushColor .
ICM: O gerenciamento de cores será executado se o ICM estiver habilitado.
Exemplos
Para obter um exemplo de configuração de cores, consulte Definindo a caneta ou a cor do pincel.
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 de contexto do dispositivo