Graphics.DrawRectangles Méthode

  • Référence

Définition

Espace de noms:
System.Drawing
Assembly:
System.Drawing.Common.dll
Assembly:
System.Drawing.dll
Paquet:
System.Drawing.Common v8.0.7
Paquet:
System.Drawing.Common v9.0.0-preview.6.24327.6

Dessine une série de rectangles spécifiés par des structures Rectangle.

Surcharges

DrawRectangles(Pen, Rectangle[])

Dessine une série de rectangles spécifiés par des structures Rectangle.
DrawRectangles(Pen, RectangleF[])

Dessine une série de rectangles spécifiés par des structures RectangleF.
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

Dessine une série de rectangles spécifiés par des structures Rectangle.

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())

Paramètres

pen
Pen

Pen qui détermine la couleur, la largeur et le style des contours des rectangles.

rects
Rectangle[]

Tableau de structures Rectangle qui représentent les rectangles à dessiner.

Exceptions

ArgumentNullException

pen est null.

-ou-

rects est null.

ArgumentException

rects est un tableau de longueur nulle.

Exemples

L’exemple de code suivant est conçu pour être utilisé avec Windows Forms et nécessite PaintEventArgse, qui est un paramètre du gestionnaire d’événements Paint. Le code effectue les actions suivantes :

  • Crée un stylet noir.

  • Crée un tableau de trois rectangles.

  • Dessine les rectangles à l’écran.

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

S’applique à

DrawRectangles(Pen, RectangleF[])

Source:
Graphics.cs
Source:
Graphics.cs
Source:
Graphics.cs
Source:
Graphics.cs
Source:
Graphics.cs

Dessine une série de rectangles spécifiés par des structures RectangleF.

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())

Paramètres

pen
Pen

Pen qui détermine la couleur, la largeur et le style des contours des rectangles.

rects
RectangleF[]

Tableau de structures RectangleF qui représentent les rectangles à dessiner.

Exceptions

ArgumentNullException

pen est null.

-ou-

rects est null.

ArgumentException

rects est un tableau de longueur nulle.

Exemples

L’exemple de code suivant est conçu pour être utilisé avec Windows Forms et nécessite PaintEventArgse, qui est un paramètre du gestionnaire d’événements Paint. Le code effectue les actions suivantes :

  • Crée un stylet noir.

  • Crée un tableau de trois rectangles.

  • Dessine les rectangles à l’écran.

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

S’applique à

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))

Paramètres

pen
Pen
rects
ReadOnlySpan<Rectangle>

S’applique à

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))

Paramètres

pen
Pen
rects
ReadOnlySpan<RectangleF>

S’applique à