Функция CreateDiscardableBitmap создает удаляемый из памяти точечный рисунок, который является совместимым с заданным устройством. Точечный рисунок имеет в формате то же самое число битов на пиксель и ту же самую цветовую палитру, что и устройство. Приложение может выбрать этот точечный рисунок как текущий битовый образ в памяти, который является совместимым с заданным устройством.
| Обратите внимание! на то, что эта функция предусматривается только для совместимости с 16-битовыми версиями Windows. Приложения должны использовать функцию CreateCompatibleBitmap. |
Синтаксис
HBITMAP CreateDiscardableBitmap( HDC hdc, // дескриптор DC int nWidth, // ширина рисунка int nHeight // высота рисунка ); |
Параметры
hdc
[in] Дескриптор контекста устройства.nWidth
[in] Определяет ширину точечного рисунка, в пикселях.nHeight
[in] Определяет высоту точечного рисунка, в пикселях.Возвращаемые значения
Если функция завершается успешно, возвращаемое значение - дескриптор совместимого точечного рисунка (DDB).
Если функция завершается ошибкой, возвращаемое значение - ПУСТО (NULL).
Windows NT/2000/XP: Чтобы получить дополнительные сведения об ошибке, вызовите GetLastError.
Замечания
Когда Вам больше не нужен точечный рисунок, вызовите функцию DeleteObject, чтобы удалить его.
Windows 95/98/Me: Созданный точечный рисунок по величине не может быть больше 16 МБ.
Смотри также
Обзор Точечные рисунки, Функции, используемые точечными рисунками, BITMAPINFOHEADER, BITMAPINFO, CreateCompatibleBitmap, DeleteObject
|
Размещение и совместимость CreateDiscardableBitmap |
|
|
Windows. NET Server |
Да |
|
Windows XP |
Да |
|
Windows 2000 |
Да |
|
Windows NT |
Да версии 3.1 и выше |
|
Windows Me |
Да |
|
Windows 98 |
Да |
|
Windows 95 |
Да |
|
Используемая библиотека |
Gdi32.lib |
|
Заголовочный файл |
|
|
- объявлено в |
Wingdi.h |
|
- включено в |
Windows.h |
|
Unicode |
Нет |
|
Замечания по платформе |
Не имеется |