Compartir a través de


Función SetDCPenColor (wingdi.h)

La función SetDCPenColor establece el color del lápiz del contexto del dispositivo (DC) actual en el valor de color especificado. Si el dispositivo no puede representar el valor de color especificado, el color se establece en el color físico más cercano.

Sintaxis

COLORREF SetDCPenColor(
  [in] HDC      hdc,
  [in] COLORREF color
);

Parámetros

[in] hdc

Identificador del controlador de dominio.

[in] color

Nuevo color de lápiz.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto especifica el color de lápiz dc anterior como un valor COLORREF . Si la función no se realiza correctamente, el valor devuelto es CLR_INVALID.

Comentarios

La función devuelve el color de DC_PEN anterior, incluso si el lápiz de stock DC_PEN no está seleccionado en el controlador de dominio; sin embargo, esto no se usará en las operaciones de dibujo hasta que se seleccione la DC_PEN de existencias en el controlador de dominio.

La función GetStockObject con un argumento de DC_BRUSH o DC_PEN se puede usar indistintamente con las funciones SetDCPenColor y SetDCBrushColor .

ICM: La administración de colores se realiza si ICM está habilitado.

Ejemplos

Para obtener un ejemplo de cómo establecer colores, vea Establecer el color de lápiz o pincel.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wingdi.h (incluye Windows.h)
Library Gdi32.lib
Archivo DLL Gdi32.dll

Consulte también

COLORREF

Funciones de contexto de dispositivo

Información general sobre contextos de dispositivo

GetDCPenColor