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
Funções de contexto do dispositivo