Graphics.DrawLine Methode

Referenz

Definition

Namespace:: System.Drawing

Assembly:: System.Drawing.Common.dll

Assembly:: System.Drawing.dll

Paket:: System.Drawing.Common v8.0.7

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

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 eine Linie, die die beiden durch die Koordinatenpaare angegebenen Punkte verbindet.

Überlädt

DrawLine(Pen, Int32, Int32, Int32, Int32)	Zeichnet eine Linie, die die beiden durch die Koordinatenpaare angegebenen Punkte verbindet.
DrawLine(Pen, Single, Single, Single, Single)	Zeichnet eine Linie, die die beiden durch die Koordinatenpaare angegebenen Punkte verbindet.
DrawLine(Pen, Point, Point)	Zeichnet eine Linie, die zwei Point Strukturen verbindet.
DrawLine(Pen, PointF, PointF)	Zeichnet eine Linie, die zwei PointF Strukturen verbindet.

DrawLine(Pen, Int32, Int32, Int32, Int32)

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Zeichnet eine Linie, die die beiden durch die Koordinatenpaare angegebenen Punkte verbindet.

public:
 void DrawLine(System::Drawing::Pen ^ pen, int x1, int y1, int x2, int y2);

public void DrawLine (System.Drawing.Pen pen, int x1, int y1, int x2, int y2);

member this.DrawLine : System.Drawing.Pen * int * int * int * int -> unit

Public Sub DrawLine (pen As Pen, x1 As Integer, y1 As Integer, x2 As Integer, y2 As Integer)

Parameter

pen: Pen

Pen, die die Farbe, Breite und Formatvorlage der Linie bestimmt.

x1: Int32

Die x-Koordinate des ersten Punkts.

y1: Int32

Die y-Koordinate des ersten Punkts.

x2: Int32

Die x-Koordinate des zweiten Punkts.

y2: Int32

Die y-Koordinate des zweiten Punkts.

Ausnahmen

ArgumentNullException

pen 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 einen schwarzen Stift.
Erstellt die Koordinaten der Endpunkte der Zeile.
Zeichnet die Linie auf dem Bildschirm.

public:
   void DrawLineInt( PaintEventArgs^ e )
   {
      // Create pen.
      Pen^ blackPen = gcnew Pen( Color::Black,3.0f );

      // Create coordinates of points that define line.
      int x1 = 100;
      int y1 = 100;
      int x2 = 500;
      int y2 = 100;

      // Draw line to screen.
      e->Graphics->DrawLine( blackPen, x1, y1, x2, y2 );
   }

public void DrawLineInt(PaintEventArgs e)
{
             
    // Create pen.
    Pen blackPen = new Pen(Color.Black, 3);
             
    // Create coordinates of points that define line.
    int x1 = 100;
    int y1 = 100;
    int x2 = 500;
    int y2 = 100;
             
    // Draw line to screen.
    e.Graphics.DrawLine(blackPen, x1, y1, x2, y2);
}

Public Sub DrawLineInt(ByVal e As PaintEventArgs)

    ' Create pen.
    Dim blackPen As New Pen(Color.Black, 3)

    ' Create coordinates of points that define line.
    Dim x1 As Integer = 100
    Dim y1 As Integer = 100
    Dim x2 As Integer = 500
    Dim y2 As Integer = 100

    ' Draw line to screen.
    e.Graphics.DrawLine(blackPen, x1, y1, x2, y2)
End Sub

Hinweise

Diese Methode zeichnet eine Linie, die die beiden durch die parameter x1, y1, x2und y2 angegebenen Parameter verbindet.

Weitere Informationen

Verwenden eines Stifts zum Zeichnen von Linien und Formen

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

DrawLine(Pen, Single, Single, Single, Single)

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Zeichnet eine Linie, die die beiden durch die Koordinatenpaare angegebenen Punkte verbindet.

public:
 void DrawLine(System::Drawing::Pen ^ pen, float x1, float y1, float x2, float y2);

public void DrawLine (System.Drawing.Pen pen, float x1, float y1, float x2, float y2);

member this.DrawLine : System.Drawing.Pen * single * single * single * single -> unit

Public Sub DrawLine (pen As Pen, x1 As Single, y1 As Single, x2 As Single, y2 As Single)

Parameter

pen: Pen

Pen, die die Farbe, Breite und Formatvorlage der Linie bestimmt.

x1: Single

Die x-Koordinate des ersten Punkts.

y1: Single

Die y-Koordinate des ersten Punkts.

x2: Single

Die x-Koordinate des zweiten Punkts.

y2: Single

Die y-Koordinate des zweiten Punkts.

Ausnahmen

ArgumentNullException

pen ist null.

Beispiele

Erstellt einen schwarzen Stift.
Erstellt die Koordinaten der Endpunkte der Zeile.
Zeichnet die Linie auf dem Bildschirm.

public:
   void DrawLineFloat( PaintEventArgs^ e )
   {
      // Create pen.
      Pen^ blackPen = gcnew Pen( Color::Black,3.0f );

      // Create coordinates of points that define line.
      float x1 = 100.0F;
      float y1 = 100.0F;
      float x2 = 500.0F;
      float y2 = 100.0F;

      // Draw line to screen.
      e->Graphics->DrawLine( blackPen, x1, y1, x2, y2 );
   }

public void DrawLineFloat(PaintEventArgs e)
{
             
    // Create pen.
    Pen blackPen = new Pen(Color.Black, 3);
             
    // Create coordinates of points that define line.
    float x1 = 100.0F;
    float y1 = 100.0F;
    float x2 = 500.0F;
    float y2 = 100.0F;
             
    // Draw line to screen.
    e.Graphics.DrawLine(blackPen, x1, y1, x2, y2);
}

Public Sub DrawLineFloat(ByVal e As PaintEventArgs)

    ' Create pen.
    Dim blackPen As New Pen(Color.Black, 3)

    ' Create coordinates of points that define line.
    Dim x1 As Single = 100.0F
    Dim y1 As Single = 100.0F
    Dim x2 As Single = 500.0F
    Dim y2 As Single = 100.0F

    ' Draw line to screen.
    e.Graphics.DrawLine(blackPen, x1, y1, x2, y2)
End Sub

Hinweise

Diese Methode zeichnet eine Linie, die die beiden durch die parameter x1, y1, x2und y2 angegebenen Parameter verbindet.

Weitere Informationen

Verwenden eines Stifts zum Zeichnen von Linien und Formen

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

DrawLine(Pen, Point, Point)

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Zeichnet eine Linie, die zwei Point Strukturen verbindet.

public:
 void DrawLine(System::Drawing::Pen ^ pen, System::Drawing::Point pt1, System::Drawing::Point pt2);

public void DrawLine (System.Drawing.Pen pen, System.Drawing.Point pt1, System.Drawing.Point pt2);

member this.DrawLine : System.Drawing.Pen * System.Drawing.Point * System.Drawing.Point -> unit

Public Sub DrawLine (pen As Pen, pt1 As Point, pt2 As Point)

Parameter

pen: Pen

Pen, die die Farbe, Breite und Formatvorlage der Linie bestimmt.

pt1: Point

Point Struktur, die den ersten zu verbindenden Punkt darstellt.

pt2: Point

Point Struktur, die den zweiten zu verbindenden Punkt darstellt.

Ausnahmen

ArgumentNullException

pen ist null.

Beispiele

Erstellt einen schwarzen Stift.
Erstellt Punkte für die Endpunkte der Zeile.
Zeichnet die Linie auf dem Bildschirm.

public:
   void DrawLinePoint( PaintEventArgs^ e )
   {
      // Create pen.
      Pen^ blackPen = gcnew Pen( Color::Black,3.0f );

      // Create points that define line.
      Point point1 = Point(100,100);
      Point point2 = Point(500,100);

      // Draw line to screen.
      e->Graphics->DrawLine( blackPen, point1, point2 );
   }

public void DrawLinePoint(PaintEventArgs e)
{
             
    // Create pen.
    Pen blackPen = new Pen(Color.Black, 3);
             
    // Create points that define line.
    Point point1 = new Point(100, 100);
    Point point2 = new Point(500, 100);
             
    // Draw line to screen.
    e.Graphics.DrawLine(blackPen, point1, point2);
}

Public Sub DrawLinePoint(ByVal e As PaintEventArgs)

    ' Create pen.
    Dim blackPen As New Pen(Color.Black, 3)

    ' Create points that define line.
    Dim point1 As New Point(100, 100)
    Dim point2 As New Point(500, 100)

    ' Draw line to screen.
    e.Graphics.DrawLine(blackPen, point1, point2)
End Sub

Weitere Informationen

Verwenden eines Stifts zum Zeichnen von Linien und Formen

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

DrawLine(Pen, PointF, PointF)

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Quelle:: Graphics.cs

Zeichnet eine Linie, die zwei PointF Strukturen verbindet.

public:
 void DrawLine(System::Drawing::Pen ^ pen, System::Drawing::PointF pt1, System::Drawing::PointF pt2);

public void DrawLine (System.Drawing.Pen pen, System.Drawing.PointF pt1, System.Drawing.PointF pt2);

member this.DrawLine : System.Drawing.Pen * System.Drawing.PointF * System.Drawing.PointF -> unit

Public Sub DrawLine (pen As Pen, pt1 As PointF, pt2 As PointF)

Parameter

pen: Pen

Pen, die die Farbe, Breite und Formatvorlage der Linie bestimmt.

pt1: PointF

PointF Struktur, die den ersten zu verbindenden Punkt darstellt.

pt2: PointF

PointF Struktur, die den zweiten zu verbindenden Punkt darstellt.

Ausnahmen

ArgumentNullException

pen ist null.

Beispiele

Erstellt einen schwarzen Stift.
Erstellt Punkte für die Endpunkte der Zeile.
Zeichnet die Linie auf dem Bildschirm.

public:
   void DrawLinePointF( PaintEventArgs^ e )
   {

      // Create pen.
      Pen^ blackPen = gcnew Pen( Color::Black,3.0f );
      
      // Create points that define line.
      PointF point1 = PointF(100.0F,100.0F);
      PointF point2 = PointF(500.0F,100.0F);

      // Draw line to screen.
      e->Graphics->DrawLine( blackPen, point1, point2 );
   }

public void DrawLinePointF(PaintEventArgs e)
{
             
    // Create pen.
    Pen blackPen = new Pen(Color.Black, 3);
             
    // Create points that define line.
    PointF point1 = new PointF(100.0F, 100.0F);
    PointF point2 = new PointF(500.0F, 100.0F);
             
    // Draw line to screen.
    e.Graphics.DrawLine(blackPen, point1, point2);
}

Public Sub DrawLinePointF(ByVal e As PaintEventArgs)

    ' Create pen.
    Dim blackPen As New Pen(Color.Black, 3)

    ' Create points that define line.
    Dim point1 As New PointF(100.0F, 100.0F)
    Dim point2 As New PointF(500.0F, 100.0F)

    ' Draw line to screen.
    e.Graphics.DrawLine(blackPen, point1, point2)
End Sub

Hinweise

Diese Methode zeichnet eine Linie, die die beiden durch die parameter pt1 und p2 angegebenen Punkte verbindet.

Weitere Informationen

Verwenden eines Stifts zum Zeichnen von Linien und Formen

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.DrawLine Methode

Definition

Überlädt

DrawLine(Pen, Int32, Int32, Int32, Int32)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

DrawLine(Pen, Single, Single, Single, Single)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

DrawLine(Pen, Point, Point)

Parameter

Ausnahmen

Beispiele

Weitere Informationen

Gilt für:

DrawLine(Pen, PointF, PointF)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Zusätzliche Ressourcen