Функция SetBkColor

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

Синтаксис

COLORREF SetBkColor(
  HDC hdc,           // дескриптор DC
  COLORREF crColor   // значение цвета фона
);

 

Параметры

hdc

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

crColor

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

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

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

Если функция завершается ошибкой, возвращаемое значение - CLR_INVALID.

Windows NT/2000/XP: Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.

Замечания

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

Если режим фона OPAQUE (НЕПРОЗРАЧНЫЙ), цвет фона используется, чтобы закрасить разрывы между стилевыми линиями, разрывы между заштрихованными линиями в кистях и знакоместах. Цвет фона также используется для преобразования точечных рисунков из цветных в монохромные и наоборот.

Демонстрационный код

Пример смотри в статье "Пример пунктов собственного меню" в разделе Использование меню.

Смотри также

Обзор Окрашивание и рисование, Функции окрашивания и рисования, COLORREF, CreatePen, ExtCreatePen, GetBKColor, GetBkMode, SetBkMode

Размещение и совместимость SetBkColor

К Windows Vista Да
л Windows XP Да
и Windows 2000 Professional Да
е Windows NT Workstation Да версии 3.1 и выше
н Windows Me Да
т Windows 98 Да
  Windows 95 Да
С Windows Server 2008 Да
е Windows Server 2003 Да
р Windows 2000 Server Да
в Windows NT Server Да версии 3.1 и выше
е
р
Используемая библиотека Gdi32.lib
Используемая DLL -
Заголовочный файл
- объявлено в Wingdi.h
- включено в Windows.h
Unicode -
Замечания по платформе Не имеется

Назад в оглавление
На главную страницу
В оглавление справки

Hosted by uCoz