Graphics.DrawImageUnscaled Methode

Referenz

Definition

Namespace:: System.Drawing

Assembly:: System.Drawing.Common.dll

Assembly:: System.Drawing.dll

Paket:: System.Drawing.Common v8.0.8

Paket:: System.Drawing.Common v9.0.0-rc.1.24451.1

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Zeichnet das angegebene Bild mithilfe seiner ursprünglichen physischen Größe an der durch ein Koordinatenpaar angegebenen Position.

Überlädt

DrawImageUnscaled(Image, Int32, Int32)	Zeichnet das angegebene Bild mithilfe seiner ursprünglichen physischen Größe an der durch ein Koordinatenpaar angegebenen Position.
DrawImageUnscaled(Image, Int32, Int32, Int32, Int32)	Zeichnet ein angegebenes Bild mit seiner ursprünglichen physischen Größe an einer bestimmten Position.
DrawImageUnscaled(Image, Point)	Zeichnet ein angegebenes Bild mit seiner ursprünglichen physischen Größe an einer bestimmten Position.
DrawImageUnscaled(Image, Rectangle)	Zeichnet ein angegebenes Bild mit seiner ursprünglichen physischen Größe an einer bestimmten Position.

DrawImageUnscaled(Image, Int32, Int32)

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Zeichnet das angegebene Bild mithilfe seiner ursprünglichen physischen Größe an der durch ein Koordinatenpaar angegebenen Position.

public:
 void DrawImageUnscaled(System::Drawing::Image ^ image, int x, int y);

public void DrawImageUnscaled (System.Drawing.Image image, int x, int y);

member this.DrawImageUnscaled : System.Drawing.Image * int * int -> unit

Public Sub DrawImageUnscaled (image As Image, x As Integer, y As Integer)

Parameter

image: Image

Image, um zu zeichnen.

x: Int32

Die x-Koordinate der oberen linken Ecke des gezeichneten Bilds.

y: Int32

Die y-Koordinate der oberen linken Ecke des gezeichneten Bilds.

Ausnahmen

ArgumentNullException

image ist null.

Beispiele

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

Erstellt ein Bild aus einer JPEG-Datei, SampImag.jpg, im Ordner des Beispiels.
Erstellt einen Punkt, an dem die obere linke Ecke des Bilds gezeichnet werden soll.
Zeichnet das gesamte Bild mithilfe seiner physischen Größe.

public:
   void DrawImageUnscaledInt( PaintEventArgs^ e )
   {
      // Create image.
      Image^ newImage = Image::FromFile( "SampImag.jpg" );

      // Create coordinates for upper-left corner of image.
      int x = 100;
      int y = 100;

      // Draw image to screen.
      e->Graphics->DrawImageUnscaled( newImage, x, y );
   }

public void DrawImageUnscaledInt(PaintEventArgs e)
{
             
    // Create image.
    Image newImage = Image.FromFile("SampImag.jpg");
             
    // Create coordinates for upper-left corner of image.
    int x = 100;
    int y = 100;
             
    // Draw image to screen.
    e.Graphics.DrawImageUnscaled(newImage, x, y);
}

Public Sub DrawImageUnscaledInt(ByVal e As PaintEventArgs)

    ' Create image.
    Dim newImage As Image = Image.FromFile("SampImag.jpg")

    ' Create coordinates for upper-left corner of image.
    Dim x As Integer = 100
    Dim y As Integer = 100

    ' Draw image to screen.
    e.Graphics.DrawImageUnscaled(newImage, x, y)
End Sub

Hinweise

Ein Image speichert einen Wert für die Pixelbreite und einen Wert für die horizontale Auflösung (Punkte pro Zoll). Die in Zoll gemessene physische Breite eines Bilds ist die Pixelbreite dividiert durch die horizontale Auflösung. Beispielsweise weist ein Bild mit einer Pixelbreite von 216 und einer horizontalen Auflösung von 72 Punkten pro Zoll eine physische Breite von 3 Zoll auf. Ähnliche Hinweise gelten für Pixelhöhe und physische Höhe.

Die DrawImageUnscaled-Methode zeichnet ein Bild mit seiner physischen Größe, sodass das Bild unabhängig von der Auflösung (Punkte pro Zoll) des Anzeigegeräts die richtige Größe in Zoll hat. Angenommen, ein Bild hat eine Pixelbreite von 216 und eine horizontale Auflösung von 72 Punkten pro Zoll. Wenn Sie DrawImageUnscaled aufrufen, um dieses Bild auf einem Gerät mit einer Auflösung von 96 Punkten pro Zoll zu zeichnen, lautet die Pixelbreite des gerenderten Bilds (216/72)*96 = 288.

Gilt für:

.NET 9 und andere Versionen

Produkt	Versionen
.NET	6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

DrawImageUnscaled(Image, Int32, Int32, Int32, Int32)

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Zeichnet ein angegebenes Bild mit seiner ursprünglichen physischen Größe an einer bestimmten Position.

public:
 void DrawImageUnscaled(System::Drawing::Image ^ image, int x, int y, int width, int height);

public void DrawImageUnscaled (System.Drawing.Image image, int x, int y, int width, int height);

member this.DrawImageUnscaled : System.Drawing.Image * int * int * int * int -> unit

Public Sub DrawImageUnscaled (image As Image, x As Integer, y As Integer, width As Integer, height As Integer)

Parameter

image: Image

Image, um zu zeichnen.

x: Int32

Die x-Koordinate der oberen linken Ecke des gezeichneten Bilds.

y: Int32

Die y-Koordinate der oberen linken Ecke des gezeichneten Bilds.

width: Int32

Wird nicht verwendet.

height: Int32

Wird nicht verwendet.

Ausnahmen

ArgumentNullException

image ist null.

Hinweise

Gilt für:

.NET 9 und andere Versionen

Produkt	Versionen
.NET	6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

DrawImageUnscaled(Image, Point)

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Zeichnet ein angegebenes Bild mit seiner ursprünglichen physischen Größe an einer bestimmten Position.

public:
 void DrawImageUnscaled(System::Drawing::Image ^ image, System::Drawing::Point point);

public void DrawImageUnscaled (System.Drawing.Image image, System.Drawing.Point point);

member this.DrawImageUnscaled : System.Drawing.Image * System.Drawing.Point -> unit

Public Sub DrawImageUnscaled (image As Image, point As Point)

Parameter

image: Image

Image, um zu zeichnen.

point: Point

Point Struktur, die die obere linke Ecke des gezeichneten Bilds angibt.

Ausnahmen

ArgumentNullException

image ist null.

Beispiele

Erstellt ein Bild aus einer JPEG-Datei SampImag.jpg im Ordner des Beispiels.
Erstellt einen Punkt, an dem die obere linke Ecke des Bilds gezeichnet werden soll.
Zeichnet das gesamte Bild mithilfe seiner physischen Größe.

public:
   void DrawImageUnscaledPoint( PaintEventArgs^ e )
   {
      // Create image.
      Image^ newImage = Image::FromFile( "SampImag.jpg" );

      // Create point for upper-left corner of image.
      Point ulCorner = Point(100,100);

      // Draw image to screen.
      e->Graphics->DrawImageUnscaled( newImage, ulCorner );
   }

public void DrawImageUnscaledPoint(PaintEventArgs e)
{
             
    // Create image.
    Image newImage = Image.FromFile("SampImag.jpg");
             
    // Create point for upper-left corner of image.
    Point ulCorner = new Point(100, 100);
             
    // Draw image to screen.
    e.Graphics.DrawImageUnscaled(newImage, ulCorner);
}

Public Sub DrawImageUnscaledPoint(ByVal e As PaintEventArgs)

    ' Create image.
    Dim newImage As Image = Image.FromFile("SampImag.jpg")

    ' Create point for upper-left corner of image.
    Dim ulCorner As New Point(100, 100)

    ' Draw image to screen.
    e.Graphics.DrawImageUnscaled(newImage, ulCorner)
End Sub

Hinweise

Gilt für:

.NET 9 und andere Versionen

Produkt	Versionen
.NET	6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

DrawImageUnscaled(Image, Rectangle)

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Zeichnet ein angegebenes Bild mit seiner ursprünglichen physischen Größe an einer bestimmten Position.

public:
 void DrawImageUnscaled(System::Drawing::Image ^ image, System::Drawing::Rectangle rect);

public void DrawImageUnscaled (System.Drawing.Image image, System.Drawing.Rectangle rect);

member this.DrawImageUnscaled : System.Drawing.Image * System.Drawing.Rectangle -> unit

Public Sub DrawImageUnscaled (image As Image, rect As Rectangle)

Parameter

image: Image

Image, um zu zeichnen.

rect: Rectangle

Rectangle, die die obere linke Ecke des gezeichneten Bilds angibt. Die X- und Y-Eigenschaften des Rechtecks geben die obere linke Ecke an. Die Eigenschaften "Width" und "Height" werden ignoriert.

Ausnahmen

ArgumentNullException

image ist null.

Hinweise

Gilt für:

.NET 9 und andere Versionen

Produkt	Versionen
.NET	6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

Teilen über

Graphics.DrawImageUnscaled Methode

Definition

Überlädt

DrawImageUnscaled(Image, Int32, Int32)

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für:

DrawImageUnscaled(Image, Int32, Int32, Int32, Int32)

Parameter

Ausnahmen

Hinweise

Gilt für:

DrawImageUnscaled(Image, Point)

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für:

DrawImageUnscaled(Image, Rectangle)

Parameter

Ausnahmen

Hinweise

Gilt für:

Zusätzliche Ressourcen