Функция SetBkMode устанавливает фоновый режим смешивания контекста заданного устройства. Фоновый режим смешивания используется текстом, кистями для штриховки и стилями пера, которые не являются сплошными линиями.
int SetBkMode( HDC hdc, // дескриптор DC int iBkMode // режим фона ); |
[in] Дескриптор контекста устройства.
iBkMode[in] Устанавливает режим фона. Этот параметр может быть одним из ниже перечисленных значений.
Значение |
Описание |
|---|---|
| OPAQUE | Фон закрашивается текущим цветом фона перед тем, как текст, кисть для штриховки или перо начнут рисовать. |
| TRANSPARENT | Фон остается нетронутым. |
Если функция завершается успешно, возвращаемое значение определяет предыдущий режим фона.
Если функция завершается ошибкой, возвращаемое значение - нуль.
Windows NT/2000/XP: Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.
Функция SetBkMode оказывает влияние на стили линий нарисованных строк при использовании пера, созданного функцией CreatePen. SetBkMode не влияет на строки, нарисованные, с использованием пера, созданным функцией ExtCreatePen.
Параметр iBkMode может также быть установлен в конкретные для драйвера значения. GDI передает такие значения драйверу устройства и, в противном случае, игнорирует их.
Пример смотри в статье Вращение строк текста.
Обзор Окрашивание и рисование, Функции окрашивания и рисования, CreatePen, ExtCreatePen, GetBkMode
Размещение и совместимость SetBkMode |
||
| К | 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 | - | |
| Замечания по платформе | Не имеется | |