Função SetDCBrushColor (wingdi.h)

Artigo
03/04/2024

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