Graphics::D rawImage(Image,constPoint,INT)-Methode (gdiplusgraphics.h)

Artikel
02/26/2024

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

Syntax

Status DrawImage(
  [in] Image       *image,
  [in] const Point *destPoints,
  [in] INT         count
);

Parameter

[in] image

Typ: Image*

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

[in] destPoints

Typ: const Point*

Zeiger auf ein Array von Point-Objekten , die den Bereich in einem Parallelogramm angeben, in dem das Bild gezeichnet werden soll.

[in] count

Typ: INT

Integer, die die Anzahl der Elemente im destPoints-Array angibt.

Rückgabewert

Typ: Status

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

Wenn die Methode fehlschlägt, wird InvalidParameter zurückgegeben.

Hinweise

Der Wert des count-Parameters muss gleich 3 sein, um die drei Ecken des Parallelogramms anzugeben. Die vierte Ecke des Parallelogramms wird mit den Vektoren der ersten und zweiten Koordinate sowie der ersten und dritten Koordinate berechnet. Das Bild wird entsprechend dem Parallelogramm skaliert.

Beispiele

Im folgenden Beispiel wird ein Bild zeichnert.

VOID Example_DrawImage(HDC hdc)

{

   Graphics graphics(hdc);

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

   // Create an array of Point objects that specify the destination of the image.
   Point destPoints[3] = {
   Point(30, 30),
   Point(250, 50),
   Point(175, 120)};

   Point* pdestPoints = destPoints;

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

Die folgende Abbildung zeigt die Ausgabe des vorangehenden Codes.

Abbildung eines zuvor rechteckigen Bilds, das jetzt in ein Parallelogramm gerundet wird

Anforderungen

Anforderung	Wert
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