Функции GDI Win-32, страница 2

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

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

Если данная обработка не имеет силу или в настоящее время отослана  в контекст устройства (DC), возвращаемое значение ложно.

Замечания

Не удаляйте графический объект, пока он используется в DC.

Побитовое отображение должно быть удалено независимо.

Функция CreateBitmapIndirect создает побитовое отображение с указанной шириной, высотой, и цветным форматом (точки пикселов).

HBITMAP CreateBitmapIndirect (

CONST BITMAP *lpbm          // адрес побитового отображения данных

);       

Параметры

Lpbm

Указатель на структуру BITMAP, которая содержит информацию относительно побитового отображения. Если установить нулевые параметры bmWidth или bmHeight, CreateBitmapIndirect возвращает обработку монохромного побитовоого отображения из 1- 1-pixel.

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

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

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

Замечания

После того, как побитовое отображение создано, оно может быть отобрано в контекст устройства при помощи функции SelectObject.

Функция CreateBitmapIndirect использьзуется, для создания цвета побитовых отображений используя CreateBitmap, чтобы создавать одноцветные побитовые отображения и CreateCompatibleBitmap, чтобы создавать цветные побитовые отображения. Когда цвет побитового отображения возвращенный от CreateBitmapIndirect отобран в контекст устройства, Windows должна гарантировать, что побитовое отображение соответствует формату контекста устройства. Пока контекст устройства CreateCompatibleBitmap установлен, возвращается побитовое отображение, которое имеет тот же самый формат что и указанный контекст устройства. Из-за этого  запросы к SelectObject работают быстрее чем  цветные побитовые отображения,  возвращенные от CreateBitmapIndirect

Если побитовое отображение одноцветено, ноли представляют цвет переднего плана, и представляют цвет фона для контекста устройства предназначения.

Если Вы больше не нуждаетесь в побитовом отображении, вызовите функцию DeleteObject, чтобы удалить его.

Функция CreateCompatibleBitmap создает побитовое отображение совместимое с устройством, которое связано с указанным контекстом устройства.

HBITMAP CreateCompatibleBitmap (

HDC hdc,      // обработка контекста устройства

Int nWidth,     // ширина побитовое отображение, в пикселах 

Int nHeight     // высота побитовое отображение, в пикселах 

);       

Параметры

Hdc

Опознает контекст устройства.

NWidth

Определяет ширину побитового отображения в пикселах.

NHeight

Определяет высоту побитового отображения в пикселах.

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

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

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

Замечания

Цветной формат побитового отображения, созданный этой функцией соответствует цветному формату устройства, идентифицированного hdc параметром. Это побитовое отображение может быть отобрано в любой контекст устройства памяти, который совместим с первоначальным устройством.

Контексты устройства памяти позволяют обрабатывать и цветные и одноцветные побитовые отображения, возвращенные функцией в  формате побитового отображения.. Однако, совместимое побитовое отображение, которое было создано для контекста устройства памяти не всегда обладает тем же самым цветовым форматом и использует ту же самую цветную палитру, как указанный контекст устройства.

Если установить нулевые параметры nWidth или nHeight, CreateCompatibleBitmap возвращает обработку монохромного побитовоого отображения из 1- 1-pixel.

Если DIB секция, которой является побитовое отображение, созданная функцией CreateDIBSection, отобрана в контекст устройства, идентифицированный hdc параметром, функция CreateCompatibleBitmap создает DIB секцию.