Graphics.DrawRectangle Methode

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)

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

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)

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)

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

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

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

Ausnahmen

pen ist null.pen is null.

Beispiele

Das folgende Codebeispiel ist für die Verwendung mit Windows Forms konzipiert und erfordert PaintEventArgse, bei dem es sich um einen Parameter des Paint Ereignis Handlers handelt.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.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

Weitere Informationen zum Zeichnen einer RectangleFfinden Sie unter DrawRectangles(Pen, RectangleF[]).For information about how to draw a RectangleF, see DrawRectangles(Pen, RectangleF[]).

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, der die Farbe, Breite und den Stil des Rechtecks bestimmt.Pen that determines the color, width, and style of the rectangle.

x
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

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

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

height
Int32

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

Ausnahmen

pen ist null.pen is null.

Beispiele

Das folgende Codebeispiel ist für die Verwendung mit Windows Forms konzipiert und erfordert PaintEventArgse, bei dem es sich um einen Parameter des Paint Ereignis Handlers handelt.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.Creates the position and size of a rectangle.

  • Zeichnet das Rechteck auf dem Bildschirm.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

Weitere Informationen zum Zeichnen einer RectangleFfinden Sie unter DrawRectangles(Pen, RectangleF[]).For information about how to draw a RectangleF, see DrawRectangles(Pen, RectangleF[]).

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

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

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

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

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

height
Single

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

Ausnahmen

pen ist null.pen is null.

Beispiele

Das folgende Codebeispiel ist für die Verwendung mit Windows Forms konzipiert und erfordert PaintEventArgse, bei dem es sich um einen Parameter des Paint Ereignis Handlers handelt.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.Creates the position and size of a rectangle.

  • Zeichnet das Rechteck auf dem Bildschirm.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

Weitere Informationen zum Zeichnen einer RectangleFfinden Sie unter DrawRectangles(Pen, RectangleF[]).For information about how to draw a RectangleF, see DrawRectangles(Pen, RectangleF[]).

Gilt für: