Graphics.DrawImageUnscaled Methode

Referenz

Definition

Namespace:: System.Drawing

Assembly:: System.Drawing.Common.dll

Assembly:: System.Drawing.dll

Paket:: System.Drawing.Common v6.0.0

Paket:: System.Drawing.Common v7.0.0

Paket:: System.Drawing.Common v8.0.0

Paket:: System.Drawing.Common v9.0.0-preview.2.24128.3

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 in seiner ursprünglichen physischen Größe an der von einem Koordinatenpaar angegebenen Position.

Überlädt

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

DrawImageUnscaled(Image, Int32, Int32)

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Zeichnet das angegebene Bild in seiner ursprünglichen physischen Größe an der von einem 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

Der zu zeichnende Image.

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 ist für die Verwendung mit Windows Forms konzipiert und erfordert PaintEventArgse, was ein Parameter des Paint Ereignishandlers ist. 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 mit 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 geteilt 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 aufrufen DrawImageUnscaled , um dieses Bild auf einem Gerät mit einer Auflösung von 96 Punkten pro Zoll zu zeichnen, beträgt die Pixelbreite des gerenderten Bilds (216/72)*96 = 288.

Gilt für:

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

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Zeichnet ein angegebenes Bild in seiner ursprünglichen physischen Größe an einer angegebenen 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

Der zu zeichnende Image.

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

Nicht verwendet.

height: Int32

Nicht verwendet.

Ausnahmen

ArgumentNullException

image ist null.

Hinweise

Gilt für:

DrawImageUnscaled(Image, Point)

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Zeichnet ein angegebenes Bild in seiner ursprünglichen physischen Größe an einer angegebenen 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

Der zu zeichnende Image.

point: Point

Point-Struktur, die die linke obere Ecke des gezeichneten Bildes 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 mit 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:

DrawImageUnscaled(Image, Rectangle)

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Zeichnet ein angegebenes Bild in seiner ursprünglichen physischen Größe an einer angegebenen 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

Der zu zeichnende Image.

rect: Rectangle

Rectangle-Struktur, die die linke obere Ecke des gezeichneten Bildes angibt. Die X-Eigenschaft und die Y-Eigenschaft des Rechtecks geben die linke obere Ecke an. Die Width-Eigenschaft und die Height-Eigenschaft werden ignoriert.

Ausnahmen

ArgumentNullException

image ist null.

Hinweise

Gilt für:

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:

Feedback

Zusätzliche Ressourcen