wingdi.h


SetBkColor

Modifica el color de fondo actual al valor especificado o al color físico más próximo si el dispositivo no puede representar ese color.

Sintaxis

COLORREF SetBkColor(
    HDC hdc,         // manipulador de contexto de dispositivo
    COLORREF crColor // valor del color de fondo
   );

Parámetros:

hdc: identificador de contexto de dispositivo.

crColor: especifica el nuevo color de fondo.

Valor de retorno

Si la función tiene éxito, el valor de retorno es valor previo del color del fondo en forma de valor COLORREF.

Si la función falla, el valor de retorno es CLR_INVALID.

Observaciones

Esta función especifica el color a usar para rellenar huecos entre líneas trazadas usando una pluma creada por la función CreatePen; no se rellenan los huecos entre líneas trazadas usando una pluma creada con la función ExtCreatePen.

Si el modo de fondo es OPAQUE, el color de fondo se usa para rellenar huecos entre líneas con estilos, huecos entre líneas en pinceles con tramas y huecos de caracteres. El color de fondo se usa también cuando se convierten mapas de bits de color a monocromo y viceversa.