Функция 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 завершается ошибкой .

Требования

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

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

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

CreateDIBSection

GetBitmapDimensionEx

SIZE