Graphics::D rawImage(Image,constRect&,INT,INT,INT,Unit,constImageAttributes,DrawImageAbort,VOID*)-Methode (gdiplusgraphics.h)

Artikel
08/24/2023

Die Graphics::D rawImage-Methode zeichnet ein Bild.

Syntax

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

Parameter

[in] image

Typ: Bild*

Zeiger auf ein Image-Objekt , das das Quellimage angibt.

[in, ref] destRect

Typ: const Rect

Verweis auf ein Rechteck, das den Zeichenbereich für das Bild eingrenzt.

[in] srcx

Typ: INT

Ganzzahl, die die x-Koordinate der oberen linken Ecke des zu zeichnenden Teils des Quellbilds angibt.

[in] srcy

Typ: INT

Ganze Zahl, die die y-Koordinate der linken oberen Ecke des zu zeichnenden Teils des Quellbilds angibt.

[in] srcwidth

Typ: INT

Ganzzahl, die die Breite des zu zeichnenden Teils des Quellbilds angibt.

[in] srcheight

Typ: INT

Ganzzahl, die die Höhe des zu zeichnenden Teils des Quellbilds angibt.

[in] srcUnit

Typ: Einheit

Element der Unit-Enumeration , die die Maßeinheit für das Bild angibt. Der Standardwert ist UnitPixel.

[in] imageAttributes

Typ: ImageAttributes*

Zeiger auf ein ImageAttributes-Objekt , das die Farb- und Größenattribute des zu zeichnenden Bilds angibt. Der Standardwert ist NULL.

[in] callback

Typ: DrawImageAbort

Rückrufmethode, die verwendet wird, um die laufende Zeichnung abzubrechen. Der Standardwert ist NULL.

[in] callbackData

Typ: VOID*

Zeiger auf zusätzliche Daten, die von der vom Rückrufparameter angegebenen Methode verwendet werden. Der Standardwert ist NULL.

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, gibt sie eines der anderen Elemente der Status-Enumeration zurück.

Hinweise

Der zu zeichnende Teil des Quellbilds wird an das Rechteck skaliert.

Beispiele

Im folgenden Beispiel wird das ursprüngliche Quellbild gezeichnet und dann ein Teil des Bilds in einem angegebenen Rechteck gezeichnet.

VOID Example_DrawImage5(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.
   int srcX = 70;
   int srcY = 20;
   int srcWidth = 100;
   int srcHeight = 100;

   // Create a Rect object that specifies the destination of the image.
   Rect destRect(200, 10, image.GetWidth(), 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);
}

Die folgende Abbildung zeigt die Ausgabe des vorherigen Codes.

Abbildung mit zwei Grafiken: ein mehrfarbiges Schachbrettmuster und dann eine zweifarbige Vergrößerung dieses Musters

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	gdiplusgraphics.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll