Функция SetBitmapDimensionEx

Функция 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

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz