Функция 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 , чтобы удалить его.

Примеры

Пример см. в статье Масштабирование изображения.

Требования

См. также раздел

Функции точечных рисунков

Общие сведения о точечных изображениях

CreateDIBSection

DeleteObject

SelectObject