Graphics.DrawRectangles Method
Definition
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>) | |
DrawRectangles(Pen, ReadOnlySpan<RectangleF>) |
DrawRectangles(Pen, Rectangle[])
- 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, 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())
Parameters
Exceptions
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
DrawRectangles(Pen, RectangleF[])
- 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, 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())
Parameters
- rects
- RectangleF[]
Array of RectangleF structures that represent the rectangles to draw.
Exceptions
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
DrawRectangles(Pen, ReadOnlySpan<Rectangle>)
- Source:
- Graphics.cs
- Source:
- Graphics.cs
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
- rects
- ReadOnlySpan<Rectangle>
Applies to
DrawRectangles(Pen, ReadOnlySpan<RectangleF>)
- Source:
- Graphics.cs
- Source:
- Graphics.cs
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
- rects
- ReadOnlySpan<RectangleF>