Graphics::D rawImage(Image*,constRectF&)-Methode (gdiplusgraphics.h)

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

Syntax

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

Parameter

[in] image

Typ: Image*

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

[in, ref] rect

Typ: const RectF

Verweis auf ein Rechteck, das den Zeichnungsbereich für das Bild begrenzt.

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

Das Bild wird skaliert, sodass es in das Rechteck passt.

Beispiele

Das folgende Beispiel zeichnet das Quellbild, das Rechteck, das das bild mit der geänderten Größe umgrenzt, und zeichnet dann das angepasste Bild an das Rechteck.

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);
}

Die folgende Abbildung zeigt die Ausgabe des vorangehenden Codes.

Abbildung, die zwei Versionen desselben Bilds zeigt; die zweite ist etwas schmaler als die erste, viel kürzer und rot umrandent.

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

Weitere Informationen

Zeichnen, Positionieren und Klonen von Bildern

Grafiken

Image

Laden und Anzeigen von Bitmaps

RectF