Graphics.DrawRectangles Methode

Definition

Zeichnet eine Reihe von Rechtecken, die durch Rectangle-Strukturen angegeben sind.

Überlädt

DrawRectangles(Pen, Rectangle[])

Zeichnet eine Reihe von Rechtecken, die durch Rectangle-Strukturen angegeben sind.

DrawRectangles(Pen, RectangleF[])

Zeichnet eine Reihe von Rechtecken, die durch RectangleF-Strukturen angegeben sind.

DrawRectangles(Pen, ReadOnlySpan<Rectangle>)
DrawRectangles(Pen, ReadOnlySpan<RectangleF>)

DrawRectangles(Pen, Rectangle[])

Zeichnet eine Reihe von Rechtecken, die durch Rectangle-Strukturen angegeben sind.

public:
 void DrawRectangles(System::Drawing::Pen ^ pen, cli::array <System::Drawing::Rectangle> ^ rects);
public:
 void DrawRectangles(System::Drawing::Pen ^ pen, ... cli::array <System::Drawing::Rectangle> ^ rects);
public void DrawRectangles (System.Drawing.Pen pen, System.Drawing.Rectangle[] rects);
public void DrawRectangles (System.Drawing.Pen pen, params System.Drawing.Rectangle[] rects);
member this.DrawRectangles : System.Drawing.Pen * System.Drawing.Rectangle[] -> unit
Public Sub DrawRectangles (pen As Pen, rects As Rectangle())
Public Sub DrawRectangles (pen As Pen, ParamArray rects As Rectangle())

Parameter

pen
Pen

Pen, der die Farbe, Breite und den Stil der Gliederungen der Rechtecke bestimmt.

rects
Rectangle[]

Array von Rectangle-Strukturen, die die zu zeichnenden Rechtecke darstellen.

Ausnahmen

pen ist null.

- oder -

rects ist null.

rects ist ein Array der Länge 0 (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 ein Array aus drei Rechtecken.

  • Zeichnet die Rechtecke auf den Bildschirm.

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

      // Create array of rectangles.
      array<Rectangle>^ rects = {Rectangle(0,0,100,200),Rectangle(100,200,250,50),Rectangle(300,0,50,100)};

      // Draw rectangles to screen.
      e->Graphics->DrawRectangles( blackPen, rects );
   }
public void DrawRectanglesRectangle(PaintEventArgs e)
{
             
    // Create pen.
    Pen blackPen = new Pen(Color.Black, 3);
             
    // Create array of rectangles.
    Rectangle[] rects =
             {
                 new Rectangle( 0,   0, 100, 200),
                 new Rectangle(100, 200, 250,  50),
                 new Rectangle(300,   0,  50, 100)
             };
             
    // Draw rectangles to screen.
    e.Graphics.DrawRectangles(blackPen, rects);
}
Public Sub DrawRectanglesRectangle(ByVal e As PaintEventArgs)

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

    ' Create array of rectangles.
    Dim rects As Rectangle() = {New Rectangle(0, 0, 100, 200), _
    New Rectangle(100, 200, 250, 50), _
    New Rectangle(300, 0, 50, 100)}

    ' Draw rectangles to screen.
    e.Graphics.DrawRectangles(blackPen, rects)
End Sub

Gilt für:

DrawRectangles(Pen, RectangleF[])

Zeichnet eine Reihe von Rechtecken, die durch RectangleF-Strukturen angegeben sind.

public:
 void DrawRectangles(System::Drawing::Pen ^ pen, cli::array <System::Drawing::RectangleF> ^ rects);
public:
 void DrawRectangles(System::Drawing::Pen ^ pen, ... cli::array <System::Drawing::RectangleF> ^ rects);
public void DrawRectangles (System.Drawing.Pen pen, System.Drawing.RectangleF[] rects);
public void DrawRectangles (System.Drawing.Pen pen, params System.Drawing.RectangleF[] rects);
member this.DrawRectangles : System.Drawing.Pen * System.Drawing.RectangleF[] -> unit
Public Sub DrawRectangles (pen As Pen, rects As RectangleF())
Public Sub DrawRectangles (pen As Pen, ParamArray rects As RectangleF())

Parameter

pen
Pen

Pen, der die Farbe, Breite und den Stil der Gliederungen der Rechtecke bestimmt.

rects
RectangleF[]

Array von RectangleF-Strukturen, die die zu zeichnenden Rechtecke darstellen.

Ausnahmen

pen ist null.

- oder -

rects ist null.

rects ist ein Array der Länge 0 (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 ein Array aus drei Rechtecken.

  • Zeichnet die Rechtecke auf den Bildschirm.

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

      // Create array of rectangles.
      array<RectangleF>^ rects = {RectangleF(0.0F,0.0F,100.0F,200.0F),RectangleF(100.0F,200.0F,250.0F,50.0F),RectangleF(300.0F,0.0F,50.0F,100.0F)};

      // Draw rectangles to screen.
      e->Graphics->DrawRectangles( blackPen, rects );
   }
public void DrawRectanglesRectangleF(PaintEventArgs e)
{
             
    // Create pen.
    Pen blackPen = new Pen(Color.Black, 3);
             
    // Create array of rectangles.
    RectangleF[] rects =
             {
                 new RectangleF( 0.0F,   0.0F, 100.0F, 200.0F),
                 new RectangleF(100.0F, 200.0F, 250.0F,  50.0F),
                 new RectangleF(300.0F,   0.0F,  50.0F, 100.0F)
             };
             
    // Draw rectangles to screen.
    e.Graphics.DrawRectangles(blackPen, rects);
}
Public Sub DrawRectanglesRectangleF(ByVal e As PaintEventArgs)

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

    ' Create array of rectangles.
    Dim rects As RectangleF() = {New RectangleF(0.0F, 0.0F, 100.0F, 200.0F), _
    New RectangleF(100.0F, 200.0F, 250.0F, 50.0F), _
    New RectangleF(300.0F, 0.0F, 50.0F, 100.0F)}

    ' Draw rectangles to screen.
    e.Graphics.DrawRectangles(blackPen, rects)
End Sub

Gilt für:

DrawRectangles(Pen, ReadOnlySpan<Rectangle>)

public:
 void DrawRectangles(System::Drawing::Pen ^ pen, ReadOnlySpan<System::Drawing::Rectangle> rects);
public void DrawRectangles (System.Drawing.Pen pen, ReadOnlySpan<System.Drawing.Rectangle> rects);
member this.DrawRectangles : System.Drawing.Pen * ReadOnlySpan<System.Drawing.Rectangle> -> unit
Public Sub DrawRectangles (pen As Pen, rects As ReadOnlySpan(Of Rectangle))

Parameter

pen
Pen

Gilt für:

DrawRectangles(Pen, ReadOnlySpan<RectangleF>)

public:
 void DrawRectangles(System::Drawing::Pen ^ pen, ReadOnlySpan<System::Drawing::RectangleF> rects);
public void DrawRectangles (System.Drawing.Pen pen, ReadOnlySpan<System.Drawing.RectangleF> rects);
member this.DrawRectangles : System.Drawing.Pen * ReadOnlySpan<System.Drawing.RectangleF> -> unit
Public Sub DrawRectangles (pen As Pen, rects As ReadOnlySpan(Of RectangleF))

Parameter

pen
Pen

Gilt für: