Función SetBkColor (wingdi.h)

Artículo
08/27/2023

La función SetBkColor establece el color de fondo actual en el valor de color especificado o en el color físico más cercano si el dispositivo no puede representar el valor de color especificado.

Sintaxis

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

Parámetros

[in] hdc

Identificador del contexto del dispositivo.

[in] color

Nuevo color de fondo. Para crear un valor COLORREF , use la macro RGB .

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto especifica el color de fondo anterior como un valor COLORREF .

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

Comentarios

Esta función rellena los espacios entre líneas con estilo dibujadas mediante un lápiz creado por la función CreatePen ; no rellena los espacios entre líneas con estilo dibujadas mediante un lápiz creado por la función ExtCreatePen . La función SetBkColor también establece los colores de fondo de TextOut y ExtTextOut.

Si el modo de fondo es opaco, el color de fondo se usa para rellenar espacios entre líneas con estilo, espacios entre líneas sombreadas en pinceles y celdas de caracteres. El color de fondo también se usa al convertir mapas de bits de color a monocromo y viceversa.

Ejemplos

Para obtener un ejemplo, vea "Ejemplo de Owner-Drawn elementos de menú" en Usar menús.

Requisitos


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