Функция CreateCompatibleBitmap (wingdi.h)
Функция CreateCompatibleBitmap создает растровое изображение, совместимое с устройством, которое связано с указанным контекстом устройства.
Синтаксис
HBITMAP CreateCompatibleBitmap(
[in] HDC hdc,
[in] int cx,
[in] int cy
);
Параметры
[in] hdc
Дескриптор для контекста устройства.
[in] cx
Ширина растрового изображения в пикселях.
[in] cy
Высота растрового изображения в пикселях.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение является дескриптором совместимого растрового изображения (DDB).
Если функция завершается сбоем, возвращается значение NULL.
Комментарии
Цветовой формат растрового рисунка, созданного функцией CreateCompatibleBitmap , соответствует цветовой формату устройства, определяемого параметром hdc . Это растровое изображение можно выбрать в любом контексте устройства памяти, совместимом с исходным устройством.
Так как контексты устройства памяти разрешают как цветовые, так и монохромные растровые изображения, формат растрового изображения, возвращаемого функцией CreateCompatibleBitmap , отличается, если указанный контекст устройства является контекстом устройства памяти. Однако совместимое растровое изображение, созданное для контекста устройства без памяти, всегда имеет тот же формат цвета и использует ту же цветовую палитру, что и указанный контекст устройства.
Примечание. При создании контекста устройства памяти в нем изначально выделено однохромное растровое изображение 1 к 1. Если этот контекст устройства памяти используется в CreateCompatibleBitmap, то созданное растровое изображение является монохромным растровым изображением . Чтобы создать цветовое растровое изображение, используйте HDC , который использовался для создания контекста устройства памяти, как показано в следующем коде:
HDC memDC = CreateCompatibleDC ( hDC );
HBITMAP memBM = CreateCompatibleBitmap ( hDC, nWidth, nHeight );
SelectObject ( memDC, memBM );
Если приложение задает для параметров nWidth или nHeight нулевое значение, CreateCompatibleBitmap возвращает дескриптор монохромного растрового изображения 1 на 1 пикселя.
Если раздел DIB, который является растровым изображением, созданным функцией CreateDIBSection , выбран в контексте устройства, определяемом параметром hdc , CreateCompatibleBitmap создает раздел DIB.
Если растровое изображение больше не требуется, вызовите функцию DeleteObject , чтобы удалить его.
Примеры
Пример см. в статье Масштабирование изображения.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | wingdi.h (включая Windows.h) |
| Библиотека | Gdi32.lib |
| DLL | Gdi32.dll |