Compartir a través de


Función SetDCBrushColor (wingdi.h)

La función SetDCBrushColor establece el color del pincel del contexto de 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 SetDCBrushColor(
  [in] HDC      hdc,
  [in] COLORREF color
);

Parámetros

[in] hdc

Identificador del controlador de dominio.

[in] color

Nuevo color de pincel.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto especifica el color del pincel dc anterior como un valor COLORREF .

Si la función no se realiza correctamente, el valor devuelto es CLR_INVALID.

Comentarios

Cuando se selecciona el DC_BRUSH de stock en un controlador de dominio, todos los dibujos posteriores se realizarán con el color del pincel dc hasta que se deseleccione el pincel de stock. El color de DC_BRUSH predeterminado es BLANCO.

La función devuelve el color del DC_BRUSH anterior, incluso si el pincel de stock DC_BRUSH 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_BRUSH 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

GetDCBrushColor