Graphics.DrawRectangles Method

Reference

Definition

Namespace:: System.Drawing

Assembly:: System.Drawing.Common.dll

Assembly:: System.Drawing.dll

Package:: System.Drawing.Common v10.0.0-preview.1.25080.3

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Draws a series of rectangles specified by Rectangle structures.

Overloads

DrawRectangles(Pen, Rectangle[])	Draws a series of rectangles specified by Rectangle structures.
DrawRectangles(Pen, RectangleF[])	Draws a series of rectangles specified by RectangleF structures.
DrawRectangles(Pen, ReadOnlySpan<Rectangle>)	Draws a series of rectangles specified by Rectangle structures.
DrawRectangles(Pen, ReadOnlySpan<RectangleF>)	Draws a series of rectangles specified by Rectangle structures.

DrawRectangles(Pen, Rectangle[])

Source:: Graphics.cs

Source:: Graphics.cs

Source:: Graphics.cs

Source:: Graphics.cs

Source:: Graphics.cs

Source:: Graphics.cs

Draws a series of rectangles specified by Rectangle structures.

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, params System.Drawing.Rectangle[] rects);

public void DrawRectangles(System.Drawing.Pen pen, System.Drawing.Rectangle[] rects);

member this.DrawRectangles : System.Drawing.Pen * System.Drawing.Rectangle[] -> unit

Public Sub DrawRectangles (pen As Pen, ParamArray rects As Rectangle())

Public Sub DrawRectangles (pen As Pen, rects As Rectangle())

Parameters

pen: Pen

Pen that determines the color, width, and style of the outlines of the rectangles.

rects: Rectangle[]

Array of Rectangle structures that represent the rectangles to draw.

Exceptions

ArgumentNullException

pen is null.

-or-

rects is null.

ArgumentException

rects is a zero-length array.

Examples

The following code example is designed for use with Windows Forms, and it requires PaintEventArgs e, which is a parameter of the Paint event handler. The code performs the following actions:

Creates a black pen.
Creates an array of three rectangles.
Draws the rectangles to the screen.

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

Applies to

.NET 10 (package-provided) och andra versioner

Produkt	Versioner
.NET	8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0 (package-provided)
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

DrawRectangles(Pen, RectangleF[])

Source:: Graphics.cs

Source:: Graphics.cs

Source:: Graphics.cs

Source:: Graphics.cs

Source:: Graphics.cs

Source:: Graphics.cs

Draws a series of rectangles specified by RectangleF structures.

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, params System.Drawing.RectangleF[] rects);

public void DrawRectangles(System.Drawing.Pen pen, System.Drawing.RectangleF[] rects);

member this.DrawRectangles : System.Drawing.Pen * System.Drawing.RectangleF[] -> unit

Public Sub DrawRectangles (pen As Pen, ParamArray rects As RectangleF())

Public Sub DrawRectangles (pen As Pen, rects As RectangleF())

Parameters

pen: Pen

Pen that determines the color, width, and style of the outlines of the rectangles.

rects: RectangleF[]

Array of RectangleF structures that represent the rectangles to draw.

Exceptions

ArgumentNullException

pen is null.

-or-

rects is null.

ArgumentException

rects is a zero-length array.

Examples

The following code example is designed for use with Windows Forms, and it requires PaintEventArgs e, which is a parameter of the Paint event handler. The code performs the following actions:

Creates a black pen.
Creates an array of three rectangles.
Draws the rectangles to the screen.

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

Applies to

.NET 10 (package-provided) och andra versioner

Produkt	Versioner
.NET	8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0 (package-provided)
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

DrawRectangles(Pen, ReadOnlySpan<Rectangle>)

Source:: Graphics.cs

Source:: Graphics.cs

Source:: Graphics.cs

Draws a series of rectangles specified by Rectangle structures.

public:
 void DrawRectangles(System::Drawing::Pen ^ pen, ReadOnlySpan<System::Drawing::Rectangle> rects);

public void DrawRectangles(System.Drawing.Pen pen, scoped 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))

Parameters

pen: Pen

Pen that determines the color, width, and style of the outlines of the rectangles.

rects: ReadOnlySpan<Rectangle>

Array of Rectangle structures that represent the rectangles to draw.

Applies to

.NET 10 (package-provided) och andra versioner

Produkt	Versioner
.NET	9 (package-provided), 10 (package-provided)
Windows Desktop	9, 10

DrawRectangles(Pen, ReadOnlySpan<RectangleF>)

Source:: Graphics.cs

Source:: Graphics.cs

Source:: Graphics.cs

Draws a series of rectangles specified by Rectangle structures.

public:
 void DrawRectangles(System::Drawing::Pen ^ pen, ReadOnlySpan<System::Drawing::RectangleF> rects);

public void DrawRectangles(System.Drawing.Pen pen, scoped 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))

Parameters

pen: Pen

Pen that determines the color, width, and style of the outlines of the rectangles.

rects: ReadOnlySpan<RectangleF>

Array of Rectangle structures that represent the rectangles to draw.

Applies to

.NET 10 (package-provided) och andra versioner

Produkt	Versioner
.NET	9 (package-provided), 10 (package-provided)
Windows Desktop	9, 10

Dela via

Graphics.DrawRectangles Method

Definition

Overloads

DrawRectangles(Pen, Rectangle[])

Parameters

Exceptions

Examples

Applies to

DrawRectangles(Pen, RectangleF[])

Parameters

Exceptions

Examples

Applies to

DrawRectangles(Pen, ReadOnlySpan<Rectangle>)

Parameters

Applies to

DrawRectangles(Pen, ReadOnlySpan<RectangleF>)

Parameters

Applies to

Ytterligare resurser