Метод Graphics::D rawImage(Image*,constRectF&) (gdiplusgraphics.h)

Статья
08/24/2023

Метод Graphics::D rawImage рисует изображение.

Синтаксис

Status DrawImage(
  [in]      Image         *image,
  [in, ref] const RectF & rect
);

Параметры

[in] image

Тип: Изображение*

Указатель на объект Image , указывающий исходное изображение.

[in, ref] rect

Тип: const RectF

Ссылка на прямоугольник, ограничивающий область рисования изображения.

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

Тип: Состояние

В случае успешного выполнения метода возвращается ОК, который является элементом перечисления Status .

Если метод завершается сбоем, он возвращает один из других элементов перечисления Status .

В следующем примере рисуется исходное изображение, прямоугольник, ограничивающий изображение с измененным размером, а затем рисуется изображение с измененным размером в соответствии с прямоугольником.

VOID Example_DrawImage10(HDC hdc)

{
   Graphics graphics(hdc);

   // Create an Image object.
   Image image(L"climber.jpg");

   // Create a Pen object.
   Pen pen (Color(255, 255, 0, 0), 2);

   // Draw the original source image.
   graphics.DrawImage(&image, 10, 10);

   // Create a RectF object that specifies the destination of the image.
   RectF destRect(200, 50, 150, 75);

   // Draw the rectangle that bounds the image.
   graphics.DrawRectangle(&pen, destRect);

   // Draw the image.
   graphics.DrawImage(&image, destRect);
}

На следующем рисунке показаны выходные данные предыдущего кода.

Иллюстрация, показывающая две версии одного и того же изображения; второй немного более узкий, чем первый, гораздо короче, и выделен красным цветом

Требования

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