Compartilhar via


Função SetDCPenColor (wingdi.h)

A função SetDCPenColor define a cor da caneta 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 SetDCPenColor(
  [in] HDC      hdc,
  [in] COLORREF color
);

Parâmetros

[in] hdc

Um identificador para o DC.

[in] color

A nova cor da caneta.

Retornar valor

Se a função for bem-sucedida, o valor retornado especificará a cor da caneta DC anterior como um valor COLORREF . Se a função falhar, o valor de retorno será CLR_INVALID.

Comentários

A função retorna a cor DC_PEN anterior, mesmo que a caneta de estoque DC_PEN não esteja selecionada no DC; no entanto, isso não será usado em operações de desenho até que a DC_PEN 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

COLORREF

Funções de contexto do dispositivo

Visão geral dos contextos do dispositivo

GetDCPenColor