Функция SetBkColor

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

Синтаксис

Параметры

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

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

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

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

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

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

Замечания

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

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

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

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

Смотри также

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