Exportieren (0) Drucken
Alle erweitern
Erweitern Minimieren

Graphics.DrawImage-Methode (Image, Point[], Rectangle, GraphicsUnit)

Zeichnet den angegebenen Bereich des angegebenen Image in der angegebenen Größe an der angegebenen Position.

Namespace: System.Drawing
Assembly: System.Drawing (in system.drawing.dll)

public void DrawImage (
	Image image,
	Point[] destPoints,
	Rectangle srcRect,
	GraphicsUnit srcUnit
)
public void DrawImage (
	Image image, 
	Point[] destPoints, 
	Rectangle srcRect, 
	GraphicsUnit srcUnit
)
public function DrawImage (
	image : Image, 
	destPoints : Point[], 
	srcRect : Rectangle, 
	srcUnit : GraphicsUnit
)

Parameter

image

Zu zeichnendes Image.

destPoints

Array von drei Point-Strukturen, die ein Parallelogramm definieren.

srcRect

Rectangle-Struktur, die den zu zeichnenden Teil des image-Objekts angibt.

srcUnit

Member der GraphicsUnit-Enumeration, der die Maßeinheiten für den srcRect-Parameter angibt.

AusnahmetypBedingung

ArgumentNullException

image ist NULL (Nothing in Visual Basic).

Der destPoints-Parameter gibt drei Punkte eines Parallelogramms an. Die drei Point-Strukturen stellen die obere linke, obere rechte und untere linke Ecke des Parallelogramms dar. Der vierte Punkt wird anhand der ersten drei Punkte ergänzt, sodass ein Parallelogramm gebildet wird.

Der srcRect-Parameter gibt einen rechteckigen Teil des zu zeichnenden image-Objekts an. Dieser Teil wird skaliert und geschert, sodass er in das durch den destPoints-Parameter angegebene Parallelogramm 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 Punkte, die ein Parallelogramm definieren, in dem das Bild gezeichnet werden soll.

  • Erstellt ein Rechteck, um den Bereich des Bildes auszuwählen, der gezeichnet werden soll.

  • Legt die Grafikzeicheneinheit auf Pixel fest.

  • Zeichnet das Bild auf dem Bildschirm.

Die Position des Parallelogramms bestimmt die Position des Bildes auf dem Bildschirm. Die Größe des Rechtecks sowie die Größe und Form des Parallelogramms bestimmen die Skalierung und die Scherung des gezeichneten Bildes.

public void DrawImageParaRect(PaintEventArgs e)
{
    // Create image.
    Image newImage = Image.FromFile("SampImag.jpg");
             
    // Create parallelogram for drawing image.
    Point ulCorner = new Point(100, 100);
    Point urCorner = new Point(325, 100);
    Point llCorner = new Point(150, 250);
    Point[] destPara = {ulCorner, urCorner, llCorner};
             
    // Create rectangle for source image.
    Rectangle srcRect = new Rectangle(50, 50, 150, 150);
    GraphicsUnit units = GraphicsUnit.Pixel;
             
    // Draw image to screen.
    e.Graphics.DrawImage(newImage, destPara, srcRect, 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

Unterstützt in: 2.0, 1.1, 1.0
Anzeigen:
© 2015 Microsoft