Graphics.DrawRectangles Methode

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v9.0.0-preview.5.24306.5

Zeichnet eine Reihe von Rechtecke, die durch Rectangle Strukturen angegeben werden.

Überlädt

DrawRectangles(Pen, Rectangle[])	Zeichnet eine Reihe von Rechtecke, die durch Rectangle Strukturen angegeben werden.
DrawRectangles(Pen, RectangleF[])	Zeichnet eine Reihe von Rechtecke, die durch RectangleF Strukturen angegeben werden.

DrawRectangles(Pen, Rectangle[])

Quelle:

Graphics.cs

Zeichnet eine Reihe von Rechtecke, die durch Rectangle Strukturen angegeben werden.

public:
 void DrawRectangles(System::Drawing::Pen ^ pen, ... cli::array <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, ParamArray rects As Rectangle())

Parameter

pen

Pen

Pen, die die Farbe, Breite und Formatvorlage der Gliederungen der Rechtecke bestimmt.

rects

Rectangle[]

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

Ausnahmen

ArgumentNullException

pen ist null.

-oder-

rects ist null.

ArgumentException

rects ist ein Array der Länge 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 Array mit drei Rechtecke.

• 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

DrawRectangles(Pen, RectangleF[])

Quelle:

Graphics.cs

Zeichnet eine Reihe von Rechtecke, die durch RectangleF Strukturen angegeben werden.

public:
 void DrawRectangles(System::Drawing::Pen ^ pen, ... cli::array <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, ParamArray rects As RectangleF())

Parameter

pen

Pen

Pen, die die Farbe, Breite und Formatvorlage der Gliederungen der Rechtecke bestimmt.

rects

RectangleF[]

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

Ausnahmen

ArgumentNullException

pen ist null.

-oder-

rects ist null.

ArgumentException

rects ist ein Array der Länge 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 Array mit drei Rechtecke.

• 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