Поделиться через


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

Функция 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

См. также раздел

COLORREF

Createpen

ExtCreatePen

GetBKColor

GetBkMode

Функции рисования и рисования

Общие сведения о рисовании и рисовании

SetBkMode