Graphics.DrawRectangle Methode

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Zeichnet ein Rechteck, das durch ein Koordinatenpaar, eine Breite und eine Höhe angegeben wird.

Überlädt

DrawRectangle(Pen, Int32, Int32, Int32, Int32)	Zeichnet ein Rechteck, das durch ein Koordinatenpaar, eine Breite und eine Höhe angegeben wird.
DrawRectangle(Pen, Single, Single, Single, Single)	Zeichnet ein Rechteck, das durch ein Koordinatenpaar, eine Breite und eine Höhe angegeben wird.
DrawRectangle(Pen, RectangleF)	Zeichnet die Kontur des angegebenen Rechtecks.
DrawRectangle(Pen, Rectangle)	Zeichnet ein durch eine Rectangle Struktur angegebenes Rechteck.

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

Zeichnet ein Rechteck, das durch ein Koordinatenpaar, eine Breite und eine Höhe angegeben wird.

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, die die Farbe, Breite und Formatvorlage 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

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 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 einer RectangleFfinden Sie unter DrawRectangles(Pen, RectangleF[]).

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

Zeichnet ein Rechteck, das durch ein Koordinatenpaar, eine Breite und eine Höhe angegeben wird.

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

Eine Pen, die die Farbe, Breite und Formatvorlage 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 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 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 einer RectangleFfinden Sie unter DrawRectangles(Pen, RectangleF[]).

DrawRectangle(Pen, RectangleF)

Zeichnet die Kontur 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 Formatvorlage des Rechtecks bestimmt.

rect

RectangleF

Das zu zeichnende Rechteck.

DrawRectangle(Pen, Rectangle)

Zeichnet ein durch eine Rectangle Struktur angegebenes Rechteck.

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

Eine Pen, die die Farbe, Breite und Formatvorlage des Rechtecks bestimmt.

rect

Rectangle

Eine Rectangle Struktur, die das zu zeichnende Rechteck darstellt.

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 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 einer RectangleFfinden Sie unter DrawRectangles(Pen, RectangleF[]).