Graphics.DrawRectangles Méthode

Définition

Espace de noms:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paquet:

System.Drawing.Common v8.0.0

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, Rectangle[])

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

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

Public Sub DrawRectangles (pen As Pen, 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 a la valeur null.

-ou-

rects a la valeur 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 Paint gestionnaire d’événements. 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

DrawRectangles(Pen, RectangleF[])

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

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

Public Sub DrawRectangles (pen As Pen, 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 a la valeur null.

-ou-

rects a la valeur 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 Paint gestionnaire d’événements. 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