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

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

Syntax

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

Parameter

[in] image

Typ: Bild*

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

[in, ref] rect

Typ: const Rect

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

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

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

Beispiele

Das folgende Beispiel zeichnet das Quellbild, das Rechteck, das das geänderte Bild eingrenzt, und zeichnet dann das geänderte Bild an das Rechteck.

VOID Example_DrawImage9(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 Rect object that specifies the destination of the image.
   Rect 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 vorherigen Codes.

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

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

Weitere Informationen

Zeichnen, Positionieren und Klonen von Bildern

Grafiken

Image

Laden und Anzeigen von Bitmaps

Rect