Поделиться через


Функция SetBitmapDimensionEx (wingdi.h)

Функция SetBitmapDimensionEx назначает точечным рисункам предпочтительные измерения. Эти измерения могут использоваться приложениями; однако они не используются системой.

Синтаксис

BOOL SetBitmapDimensionEx(
  [in]  HBITMAP hbm,
  [in]  int     w,
  [in]  int     h,
  [out] LPSIZE  lpsz
);

Параметры

[in] hbm

Дескриптор растрового изображения. Растровое изображение не может быть растровым изображением раздела DIB.

[in] w

Ширина растрового изображения в единицах 0,1 миллиметра.

[in] h

Высота растрового изображения в единицах 0,1 миллиметра.

[out] lpsz

Указатель на структуру SIZE для получения предыдущих размеров растрового изображения. Этот указатель может иметь значение NULL.

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение.

Комментарии

Приложение может получить измерения, назначенные растровому рисунку, с помощью функции SetBitmapDimensionEx , вызвав функцию GetBitmapDimensionEx .

Растровое изображение, определяемое hBitmap , не может быть разделом DIB, который является растровым рисунком, созданным функцией CreateDIBSection . Если растровое изображение является разделом DIB, функция SetBitmapDimensionEx завершается ошибкой .

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header wingdi.h (включая Windows.h)
Библиотека Gdi32.lib
DLL Gdi32.dll

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

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

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

CreateDIBSection

GetBitmapDimensionEx

SIZE