Graphics::D rawImage(Image,constRectF&,REAL,REAL,REAL,REAL,Unit,constImageAttributes,DrawImageAbort,VOID*) (gdiplusgraphics.h)

Статья
01/10/2024

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

Синтаксис

Status DrawImage(
  [in]      Image                 *image,
  [in, ref] const RectF &         destRect,
  [in]      REAL                  srcx,
  [in]      REAL                  srcy,
  [in]      REAL                  srcwidth,
  [in]      REAL                  srcheight,
  [in]      Unit                  srcUnit,
  [in]      const ImageAttributes *imageAttributes,
  [in]      DrawImageAbort        callback,
  [in]      VOID                  *callbackData
);

Параметры

[in] image

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

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

[in, ref] destRect

Тип: const RectF

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

[in] srcx

Тип: REAL

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

[in] srcy

Тип: REAL

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

[in] srcwidth

Тип: REAL

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

[in] srcheight

Тип: REAL

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

[in] srcUnit

Тип: Единица измерения

Элемент перечисления Unit , задающий единицу измерения для изображения. Значение по умолчанию — UnitPixel.

[in] imageAttributes

Тип: ImageAttributes*

Указатель на объект ImageAttributes , указывающий атрибуты цвета и размера рисуемого изображения. Значение по умолчанию — NULL.

[in] callback

Тип: DrawImageAbort

Метод обратного вызова, используемый для отмены выполняемого рисования. Значение по умолчанию — NULL.

[in] callbackData

Тип: VOID*

Указатель на дополнительные данные, используемые методом, заданным параметром обратного вызова . Значение по умолчанию — NULL.

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

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

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

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

VOID Example_DrawImage6(HDC hdc)

{

   Graphics graphics(hdc);



   // Create an Image object.

   Image image(L"pattern.png");



   // Draw the original source image.

   graphics.DrawImage(&image, 10, 10);



   // Define the portion of the image to draw.

   REAL srcX = 70.0f;

   REAL srcY = 20.0f;

   REAL srcWidth = 100.0f;

   REAL srcHeight = 100.0f;



   // Create a RectF object that specifies the destination of the image.

   RectF destRect(200.0f, 10.0f, <REAL>image.GetWidth(), <REAL>image.GetHeight());

   

   // Create an ImageAttributes object that specifies a recoloring from red to blue.

   ImageAttributes remapAttributes;

   ColorMap redToBlue;

   redToBlue.oldColor = Color(255, 255, 0, 0);

   redToBlue.newColor = Color(255, 0, 0, 255);

   remapAttributes.SetRemapTable(1, &redToBlue);



   // Draw the resized image.

   graphics.DrawImage(

   &image,

   destRect,

   srcX,

   srcY,

   srcWidth,

   srcHeight,

   UnitPixel,

   &remapAttributes,

   NULL,

   NULL);

}

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

Иллюстрация, показывающая две графики: разноцветный шаблон клетчатой доски, а затем двухтонное увеличение от этого шаблона

Требования


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