Graphics.DrawImage-Methode (Image, Rectangle, Int32, Int32, Int32, Int32, GraphicsUnit)

public void DrawImage (
	Image image,
	Rectangle destRect,
	int srcX,
	int srcY,
	int srcWidth,
	int srcHeight,
	GraphicsUnit srcUnit
)

public void DrawImage (
	Image image, 
	Rectangle destRect, 
	int srcX, 
	int srcY, 
	int srcWidth, 
	int srcHeight, 
	GraphicsUnit srcUnit
)

public function DrawImage (
	image : Image, 
	destRect : Rectangle, 
	srcX : int, 
	srcY : int, 
	srcWidth : int, 
	srcHeight : int, 
	srcUnit : GraphicsUnit
)

Parameter

image

Zu zeichnendes Image.

destRect

Rectangle-Struktur, die die Position und Größe des gezeichneten Bildes angibt. Das Bild wird skaliert, sodass es in das Rechteck passt.

srcX

Die X-Koordinate der oberen linken Ecke des zu zeichnenden Bereichs des Quellbildes.

srcY

Die Y-Koordinate der oberen linken Ecke des zu zeichnenden Bereichs des Quellbildes.

srcWidth

Breite des zu zeichnenden Bereichs des Quellbildes.

srcHeight

Höhe des zu zeichnenden Bereichs des Quellbildes.

srcUnit

Member der GraphicsUnit-Enumeration, der die Maßeinheiten angibt, mit denen das Quellrechteck bestimmt wird.

Der srcX-Parameter, der srcY-Parameter, der srcWidth-Parameter und der srcHeight-Parameter geben einen rechteckigen Teil des zu zeichnenden image-Objekts an. Das Rechteck ist relativ zur linken oberen Ecke des Quellbildes angegeben. Dieser Teil wird skaliert, sodass er in das durch den destRect-Parameter angegebene Rechteck passt.

Das folgende Codebeispiel ist für die Verwendung mit Windows Forms vorgesehen und erfordert PaintEventArgse, wobei es sich um einen Parameter des Paint-Ereignishandlers handelt. Der Code führt die folgenden Aktionen aus:

• Erstellt ein Bild aus der JPEG-Datei SampImag.jpg im Beispielordner.

• Erstellt ein Zielrechteck, in dem das Bild gezeichnet werden soll.

• Erstellt die Koordinaten eines Quellrechtecks, aus dem ein Teil des Bildes extrahiert werden soll.

• Legt die Maßeinheit des Quellrechtecks auf Pixel fest.

• Zeichnet das Bild auf dem Bildschirm.

Die Position des Zielrechtecks bestimmt die Position des Bildes auf dem Bildschirm, die Größe des Quellrechtecks und die Größe des Zielrechtecks bestimmen die Skalierung des gezeichneten Bildes, und die Größe des Quellrechtecks bestimmt, welcher Teil des ursprünglichen Bildes auf dem Bildschirm gezeichnet wird.

public void DrawImageRect4Int(PaintEventArgs e)
{
             
    // Create image.
    Image newImage = Image.FromFile("SampImag.jpg");
             
    // Create rectangle for displaying image.
    Rectangle destRect = new Rectangle(100, 100, 450, 150);
             
    // Create coordinates of rectangle for source image.
    int x = 50;
    int y = 50;
    int width = 150;
    int height = 150;
    GraphicsUnit units = GraphicsUnit.Pixel;
             
    // Draw image to screen.
    e.Graphics.DrawImage(newImage, destRect, x, y, width, height, units);
}

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

.NET Framework