Graphics.DrawRectangle Graphics.DrawRectangle Graphics.DrawRectangle Method

Definition

Zeichnet ein Rechteck, das durch ein Koordinatenpaar, eine Breiten- und eine Höhenangabe angegeben ist.Draws a rectangle specified by a coordinate pair, a width, and a height.

Überlädt

DrawRectangle(Pen, Rectangle) DrawRectangle(Pen, Rectangle) DrawRectangle(Pen, Rectangle)

Zeichnet ein Rechteck, das von einer Rectangle-Struktur angegeben ist.Draws a rectangle specified by a Rectangle structure.

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

Zeichnet ein Rechteck, das durch ein Koordinatenpaar, eine Breiten- und eine Höhenangabe angegeben ist.Draws a rectangle specified by a coordinate pair, a width, and a height.

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

Zeichnet ein Rechteck, das durch ein Koordinatenpaar, eine Breiten- und eine Höhenangabe angegeben ist.Draws a rectangle specified by a coordinate pair, a width, and a height.

DrawRectangle(Pen, Rectangle) DrawRectangle(Pen, Rectangle) DrawRectangle(Pen, Rectangle)

Zeichnet ein Rechteck, das von einer Rectangle-Struktur angegeben ist.Draws a rectangle specified by a Rectangle structure.

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

Parameter

pen
Pen Pen Pen

Ein Pen, der die Farbe, Breite und den Stil des Rechtecks bestimmt.A Pen that determines the color, width, and style of the rectangle.

rect
Rectangle Rectangle Rectangle

Eine Rectangle-Struktur, die das zu zeichnende Rechteck darstellt.A Rectangle structure that represents the rectangle to draw.

Ausnahmen

Beispiele

Im folgenden Codebeispiel wird für die Verwendung mit Windows Forms konzipiert und erfordert PaintEventArgs e, ein Parameter von der Paint -Ereignishandler.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Der Code führt die folgenden Aktionen aus:The code performs the following actions:

  • Erstellt einen schwarzen Stift.Creates a black pen.

  • Erstellt ein Rechteck.Creates a rectangle.

  • Zeichnet das Rechteck auf dem Bildschirm an.Draws the rectangle to the screen.

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 RectangleF, finden Sie unter DrawRectangles(Pen, RectangleF[]).For information about how to draw a RectangleF, see DrawRectangles(Pen, RectangleF[]).

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

Zeichnet ein Rechteck, das durch ein Koordinatenpaar, eine Breiten- und eine Höhenangabe angegeben ist.Draws a rectangle specified by a coordinate pair, a width, and a height.

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

Parameter

pen
Pen Pen Pen

Pen, der die Farbe, Breite und den Stil des Rechtecks bestimmt.Pen that determines the color, width, and style of the rectangle.

x
Int32 Int32 Int32

Die X-Koordinate der oberen linken Ecke des zu zeichnenden Rechtecks.The x-coordinate of the upper-left corner of the rectangle to draw.

y
Int32 Int32 Int32

Die Y-Koordinate der oberen linken Ecke des zu zeichnenden Rechtecks.The y-coordinate of the upper-left corner of the rectangle to draw.

width
Int32 Int32 Int32

Breite des zu zeichnenden Rechtecks.Width of the rectangle to draw.

height
Int32 Int32 Int32

Höhe des zu zeichnenden Rechtecks.Height of the rectangle to draw.

Ausnahmen

Beispiele

Im folgenden Codebeispiel wird für die Verwendung mit Windows Forms konzipiert und erfordert PaintEventArgs e, ein Parameter von der Paint -Ereignishandler.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Der Code führt die folgenden Aktionen aus:The code performs the following actions:

  • Erstellt einen schwarzen Stift.Creates a black pen.

  • Erstellt die Position und Größe eines Rechtecks an.Creates the position and size of a rectangle.

  • Zeichnet das Rechteck auf dem Bildschirm an.Draws the rectangle to the screen.

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 RectangleF, finden Sie unter DrawRectangles(Pen, RectangleF[]).For information about how to draw a RectangleF, see DrawRectangles(Pen, RectangleF[]).

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

Zeichnet ein Rechteck, das durch ein Koordinatenpaar, eine Breiten- und eine Höhenangabe angegeben ist.Draws a rectangle specified by a coordinate pair, a width, and a height.

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

Parameter

pen
Pen Pen Pen

Ein Pen, der die Farbe, Breite und den Stil des Rechtecks bestimmt.A Pen that determines the color, width, and style of the rectangle.

x
Single Single Single

Die X-Koordinate der oberen linken Ecke des zu zeichnenden Rechtecks.The x-coordinate of the upper-left corner of the rectangle to draw.

y
Single Single Single

Die Y-Koordinate der oberen linken Ecke des zu zeichnenden Rechtecks.The y-coordinate of the upper-left corner of the rectangle to draw.

width
Single Single Single

Die Breite des zu zeichnenden Rechtecks.The width of the rectangle to draw.

height
Single Single Single

Die Höhe des zu zeichnenden Rechtecks.The height of the rectangle to draw.

Ausnahmen

Beispiele

Im folgenden Codebeispiel wird für die Verwendung mit Windows Forms konzipiert und erfordert PaintEventArgs e, ein Parameter von der Paint -Ereignishandler.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Der Code führt die folgenden Aktionen aus:The code performs the following actions:

  • Erstellt einen schwarzen Stift.Creates a black pen.

  • Erstellt die Position und Größe eines Rechtecks an.Creates the position and size of a rectangle.

  • Zeichnet das Rechteck auf dem Bildschirm an.Draws the rectangle to the screen.

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 RectangleF, finden Sie unter DrawRectangles(Pen, RectangleF[]).For information about how to draw a RectangleF, see DrawRectangles(Pen, RectangleF[]).

Gilt für: