Функция SetBkColor устанавливает текущий цвет фона в заданном коде цвета или в самом близком физическом цвете, если устройство не может предоставить указанный код цвета.
COLORREF SetBkColor( HDC hdc, // дескриптор DC COLORREF crColor // значение цвета фона );
|
[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 | - | |
Замечания по платформе | Не имеется |