Функция SetBitmapDimensionEx назначает предпочтительные размеры точечному рисунку. Эти размеры могут быть использованы приложениями; однако они не используются системой.
Синтаксис
BOOL SetBitmapDimensionEx( HBITMAP hBitmap, // дескриптор рисунка int nWidth, // ширина рисунка в .01 мм int nHeight, // высота рисунка в .01 мм LPSIZE lpSize // исходные размеры ); |
Параметры
hBitmap
[in] Дескриптор точечного рисунка. Точечным рисунком не может быть битовый образ DIB-секции.nWidth
[in] Устанавливает ширину точечного рисунка, в единицах измерения равных .01 миллиметра.nHeight
[in] Устанавливает высоту точечного рисунка, в единицах измерения равных .01 миллиметра.lpSize
[out] Указатель на структуру SIZE, которая принимает предыдущие размеры точечного рисунка. Этот указатель может иметь значение ПУСТО (NULL).Возвращаемые значения
Если функция завершается успешно, возвращаемое значение - не нуль.
Если функция завершается с ошибкой, величина возвращаемого значения - нуль.
Windows NT/2000/XP: Чтобы получать дополнительные сведения об ошибке, вызовите GetLastError.
Замечания
Приложение может извлечь назначенные размеры точечному рисунку функцией SetBitmapDimensionEx при помощи вызова функция GetBitmapDimensionEx.
Точечный рисунок, идентифицированный hBitmap не может быть DIB-секцией, которая является битовым образом, созданным функцией CreateDIBSection. Если точечный рисунок - DIB-секция, функция SetBitmapDimensionEx завершается ошибкой.
Смотри также
Обзор Точечные рисунки, Функции, используемые точечными рисунками, CreateDIBSection, GetBitmapDimensionEx, SIZE
|
Размещение и совместимость SetBitmapDimensionEx |
|
|
Windows. NET Server |
Да |
|
Windows XP |
Да |
|
Windows 2000 |
Да |
|
Windows NT |
Да версии 3.1 и выше |
|
Windows Me |
Нет |
|
Windows 98 |
Нет |
|
Windows 95 |
Нет |
|
Используемая библиотека |
Gdi32.lib |
|
Заголовочный файл |
|
|
- объявлено в |
Wingdi.h |
|
- включено в |
Windows.h |
|
Unicode |
Нет |
|
Замечания по платформе |
Не имеется |