Функция SetBkColor (wingdi.h)

2023-08-27

Функция SetBkColor задает для текущего цвета фона указанное значение цвета или ближайший физический цвет, если устройство не может представить указанное значение цвета.

Синтаксис

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

Параметры

[in] hdc

Дескриптор контекста устройства.

[in] color

Новый цвет фона. Чтобы создать значение COLORREF , используйте макрос RGB .

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение указывает предыдущий цвет фона в качестве значения COLORREF .

Если функция выполняется неудачно, возвращается значение CLR_INVALID.

Эта функция заполняет пробелы между стилями линий, нарисованных с помощью пера, созданного функцией CreatePen ; он не заполняет пробелы между стилистируемыми линиями, нарисованными с помощью пера, созданного функцией ExtCreatePen . Функция SetBkColor также задает цвета фона для TextOut и ExtTextOut.

Если фоновый режим является OPAQUE, цвет фона используется для заполнения пробелов между стилем линий, пробелов между штриховками в кисти и символьных ячеек. Цвет фона также используется при преобразовании растровых изображений из цвета в монохромные и наоборот.

Примеры

Пример см. в разделе "Пример элементов меню Owner-Drawn" статьи Использование меню.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	wingdi.h (включая Windows.h)
Библиотека	Gdi32.lib
DLL	Gdi32.dll