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

Artikel
08/24/2023

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

Syntax

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

Parameter

[in] image

Typ: Image*

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

[in] destPoints

Typ: const PointF*

Zeiger auf ein Array von PointF-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 eines der anderen Elemente der Status-Enumeration zurückgegeben.

Hinweise

Der Wert des count-Parameters muss gleich 3 sein, um die Koordinaten der oberen linken Ecke, der oberen rechten Ecke und der unteren linken Ecke des Parallelogramms anzugeben. Die Koordinate der unteren rechten Ecke wird anhand der drei angegebenen Koordinaten, der Breite und der Höhe des Bilds berechnet. Das Bild wird entsprechend dem Parallelogramm skaliert.

Beispiele

Im folgenden Beispiel wird ein Bild zeichnert.

VOID Example_DrawImage3(HDC hdc)

{
   Graphics graphics(hdc);

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

   // Create an array of PointF objects that specify the destination of the image.
   PointF destPoints[3] = {
   PointF(30.0f, 30.0f),
   PointF(250.0f, 50.0f),
   PointF(175.0f, 120.0f)};

   PointF* 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 zu einem Parallelogramm gestrichelt wurde

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