Graphics.DrawRectangles 方法

定义

命名空间:

System.Drawing

程序集:

System.Drawing.Common.dll

包:

System.Drawing.Common v8.0.0

绘制一系列由 Rectangle 结构指定的矩形。

重载

DrawRectangles(Pen, Rectangle[])	绘制一系列由 Rectangle 结构指定的矩形。
DrawRectangles(Pen, RectangleF[])	绘制一系列由 RectangleF 结构指定的矩形。

DrawRectangles(Pen, Rectangle[])

Source:

Graphics.cs

绘制一系列由 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())

参数

pen

Pen

Pen，它确定矩形轮廓线的颜色、宽度和样式。

rects

Rectangle[]

Rectangle 结构数组，这些结构表示要绘制的矩形。

例外

ArgumentNullException

pen 为 null。

或

rects 为 null。

ArgumentException

rects 是一个长度为零的数组。

示例

下面的代码示例旨在与 Windows 窗体 一起使用，它需要 PaintEventArgse，这是事件处理程序的参数Paint。 此代码执行以下操作：

• 创建黑色笔。

• 创建一个包含三个矩形的数组。

• 将矩形绘制到屏幕。

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

绘制一系列由 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())

参数

pen

Pen

Pen，它确定矩形轮廓线的颜色、宽度和样式。

rects

RectangleF[]

RectangleF 结构数组，这些结构表示要绘制的矩形。

例外

ArgumentNullException

pen 为 null。

或

rects 为 null。

ArgumentException

rects 是一个长度为零的数组。

示例

下面的代码示例旨在与 Windows 窗体 一起使用，它需要 PaintEventArgse，这是事件处理程序的参数Paint。 此代码执行以下操作：

• 创建黑色笔。

• 创建一个包含三个矩形的数组。

• 将矩形绘制到屏幕。

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