Graphics.DrawRectangle 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

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 ein Rechteck, das durch ein Koordinatenpaar, eine Breiten- und eine Höhenangabe angegeben ist.

Überlädt

DrawRectangle(Pen, Single, Single, Single, Single)	Zeichnet ein Rechteck, das durch ein Koordinatenpaar, eine Breiten- und eine Höhenangabe angegeben ist.
DrawRectangle(Pen, Int32, Int32, Int32, Int32)	Zeichnet ein Rechteck, das durch ein Koordinatenpaar, eine Breiten- und eine Höhenangabe angegeben ist.
DrawRectangle(Pen, RectangleF)	Zeichnet den Umriss des angegebenen Rechtecks.
DrawRectangle(Pen, Rectangle)	Zeichnet ein Rechteck, das von einer Rectangle-Struktur angegeben ist.

DrawRectangle(Pen, Single, Single, Single, Single)

Zeichnet ein Rechteck, das durch ein Koordinatenpaar, eine Breiten- und eine Höhenangabe angegeben ist.

public:
 void DrawRectangle(System::Drawing::Pen ^ pen, float x, float y, float width, float height);

public void DrawRectangle (System.Drawing.Pen pen, float x, float y, float width, float height);

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

Public Sub DrawRectangle (pen As Pen, x As Single, y As Single, width As Single, height As Single)

Parameter

pen: Pen

Ein Pen, der die Farbe, Breite und den Stil des Rechtecks bestimmt.

x: Single

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

y: Single

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

width: Single

Die Breite des zu zeichnenden Rechtecks.

height: Single

Die Höhe des zu zeichnenden Rechtecks.

Ausnahmen

ArgumentNullException

pen 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 einen schwarzen Stift.
Erstellt die Position und Größe eines Rechtecks.
Zeichnet das Rechteck auf den Bildschirm.

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

      // Create location and size of rectangle.
      float x = 0.0F;
      float y = 0.0F;
      float width = 200.0F;
      float height = 200.0F;

      // Draw rectangle to screen.
      e->Graphics->DrawRectangle( blackPen, x, y, width, height );
   }

public void DrawRectangleFloat(PaintEventArgs e)
{
             
    // Create pen.
    Pen blackPen = new Pen(Color.Black, 3);
             
    // Create location and size of rectangle.
    float x = 0.0F;
    float y = 0.0F;
    float width = 200.0F;
    float height = 200.0F;
             
    // Draw rectangle to screen.
    e.Graphics.DrawRectangle(blackPen, x, y, width, height);
}

Public Sub DrawRectangleFloat(ByVal e As PaintEventArgs)

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

    ' Create location and size of rectangle.
    Dim x As Single = 0.0F
    Dim y As Single = 0.0F
    Dim width As Single = 200.0F
    Dim height As Single = 200.0F

    ' Draw rectangle to screen.
    e.Graphics.DrawRectangle(blackPen, x, y, width, height)
End Sub

Hinweise

Informationen zum Zeichnen eines RectangleFfinden Sie unter DrawRectangles(Pen, RectangleF[]).

Gilt für:

DrawRectangle(Pen, Int32, Int32, Int32, Int32)

Zeichnet ein Rechteck, das durch ein Koordinatenpaar, eine Breiten- und eine Höhenangabe angegeben ist.

public:
 void DrawRectangle(System::Drawing::Pen ^ pen, int x, int y, int width, int height);

public void DrawRectangle (System.Drawing.Pen pen, int x, int y, int width, int height);

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

Public Sub DrawRectangle (pen As Pen, x As Integer, y As Integer, width As Integer, height As Integer)

Parameter

pen: Pen

Pen, der die Farbe, Breite und den Stil des Rechtecks bestimmt.

x: Int32

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

y: Int32

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

width: Int32

Breite des zu zeichnenden Rechtecks.

height: Int32

Höhe des zu zeichnenden Rechtecks.

Ausnahmen

ArgumentNullException

pen ist null.

Beispiele

Erstellt einen schwarzen Stift.
Erstellt die Position und Größe eines Rechtecks.
Zeichnet das Rechteck auf den Bildschirm.

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

      // Create location and size of rectangle.
      int x = 0;
      int y = 0;
      int width = 200;
      int height = 200;

      // Draw rectangle to screen.
      e->Graphics->DrawRectangle( blackPen, x, y, width, height );
   }

public void DrawRectangleInt(PaintEventArgs e)
{
             
    // Create pen.
    Pen blackPen = new Pen(Color.Black, 3);
             
    // Create location and size of rectangle.
    int x = 0;
    int y = 0;
    int width = 200;
    int height = 200;
             
    // Draw rectangle to screen.
    e.Graphics.DrawRectangle(blackPen, x, y, width, height);
}

Public Sub DrawRectangleInt(ByVal e As PaintEventArgs)

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

    ' Create location and size of rectangle.
    Dim x As Integer = 0
    Dim y As Integer = 0
    Dim width As Integer = 200
    Dim height As Integer = 200

    ' Draw rectangle to screen.
    e.Graphics.DrawRectangle(blackPen, x, y, width, height)
End Sub

Hinweise

Informationen zum Zeichnen eines RectangleFfinden Sie unter DrawRectangles(Pen, RectangleF[]).

Gilt für:

DrawRectangle(Pen, RectangleF)

Zeichnet den Umriss des angegebenen Rechtecks.

public:
 void DrawRectangle(System::Drawing::Pen ^ pen, System::Drawing::RectangleF rect);

public void DrawRectangle (System.Drawing.Pen pen, System.Drawing.RectangleF rect);

member this.DrawRectangle : System.Drawing.Pen * System.Drawing.RectangleF -> unit

Public Sub DrawRectangle (pen As Pen, rect As RectangleF)

Parameter

pen: Pen

Ein Stift, der die Farbe, Breite und Stil des Rechtecks bestimmt.

rect: RectangleF

Das zu zeichnende Rechteck.

Gilt für:

DrawRectangle(Pen, Rectangle)

Zeichnet ein Rechteck, das von einer Rectangle-Struktur angegeben ist.

public:
 void DrawRectangle(System::Drawing::Pen ^ pen, System::Drawing::Rectangle rect);

public void DrawRectangle (System.Drawing.Pen pen, System.Drawing.Rectangle rect);

member this.DrawRectangle : System.Drawing.Pen * System.Drawing.Rectangle -> unit

Public Sub DrawRectangle (pen As Pen, rect As Rectangle)

Parameter

pen: Pen

Ein Pen, der die Farbe, Breite und den Stil des Rechtecks bestimmt.

rect: Rectangle

Eine Rectangle-Struktur, die das zu zeichnende Rechteck darstellt.

Ausnahmen

ArgumentNullException

pen ist null.

Beispiele

Erstellt einen schwarzen Stift.
Erstellt ein Rechteck.
Zeichnet das Rechteck auf den Bildschirm.

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

      // Create rectangle.
      Rectangle rect = Rectangle(0,0,200,200);

      // Draw rectangle to screen.
      e->Graphics->DrawRectangle( blackPen, rect );
   }

public void DrawRectangleRectangle(PaintEventArgs e)
{
             
    // Create pen.
    Pen blackPen = new Pen(Color.Black, 3);
             
    // Create rectangle.
    Rectangle rect = new Rectangle(0, 0, 200, 200);
             
    // Draw rectangle to screen.
    e.Graphics.DrawRectangle(blackPen, rect);
}

Public Sub DrawRectangleRectangle(ByVal e As PaintEventArgs)

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

    ' Create rectangle.
    Dim rect As New Rectangle(0, 0, 200, 200)

    ' Draw rectangle to screen.
    e.Graphics.DrawRectangle(blackPen, rect)
End Sub

Hinweise

Informationen zum Zeichnen eines RectangleFfinden Sie unter DrawRectangles(Pen, RectangleF[]).

Gilt für:

Graphics.DrawRectangle Methode

Definition

Überlädt

DrawRectangle(Pen, Single, Single, Single, Single)

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für:

DrawRectangle(Pen, Int32, Int32, Int32, Int32)

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für:

DrawRectangle(Pen, RectangleF)

Parameter

Gilt für:

DrawRectangle(Pen, Rectangle)

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für:

Zusätzliche Ressourcen