Graphics.DrawRectangle Method

Definition

Рисует прямоугольник, определяемый парой координат, шириной и высотой.Draws a rectangle specified by a coordinate pair, a width, and a height.

Overloads

DrawRectangle(Pen, Rectangle)

Рисует прямоугольник, определяемый структурой Rectangle.Draws a rectangle specified by a Rectangle structure.

DrawRectangle(Pen, Int32, Int32, Int32, Int32)

Рисует прямоугольник, определяемый парой координат, шириной и высотой.Draws a rectangle specified by a coordinate pair, a width, and a height.

DrawRectangle(Pen, Single, Single, Single, Single)

Рисует прямоугольник, определяемый парой координат, шириной и высотой.Draws a rectangle specified by a coordinate pair, a width, and a height.

DrawRectangle(Pen, Rectangle)

Рисует прямоугольник, определяемый структурой Rectangle.Draws a rectangle specified by a Rectangle structure.

public:
 void DrawRectangle(System::Drawing::Pen ^ pen, System::Drawing::Rectangle rect);
public void DrawRectangle (System.Drawing.Pen pen, System.Drawing.Rectangle rect);
member this.DrawRectangle : System.Drawing.Pen * System.Drawing.Rectangle -> unit
Public Sub DrawRectangle (pen As Pen, rect As Rectangle)

Parameters

pen
Pen

Структура Pen, определяющая цвет, ширину и стиль прямоугольника.A Pen that determines the color, width, and style of the rectangle.

rect
Rectangle

Структура Rectangle, представляющая прямоугольник для рисования.A Rectangle structure that represents the rectangle to draw.

Exceptions

Параметр pen равен null.pen is null.

Examples

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика событий Paint.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Код выполняет следующие действия.The code performs the following actions:

  • Создает черное перо.Creates a black pen.

  • Создает прямоугольник.Creates a rectangle.

  • Отображает прямоугольник на экране.Draws the rectangle to the screen.

public:
   void DrawRectangleRectangle( PaintEventArgs^ e )
   {
      // Create pen.
      Pen^ blackPen = gcnew Pen( Color::Black,3.0f );

      // Create rectangle.
      Rectangle rect = Rectangle(0,0,200,200);

      // Draw rectangle to screen.
      e->Graphics->DrawRectangle( blackPen, rect );
   }
public void DrawRectangleRectangle(PaintEventArgs e)
{
             
    // Create pen.
    Pen blackPen = new Pen(Color.Black, 3);
             
    // Create rectangle.
    Rectangle rect = new Rectangle(0, 0, 200, 200);
             
    // Draw rectangle to screen.
    e.Graphics.DrawRectangle(blackPen, rect);
}
Public Sub DrawRectangleRectangle(ByVal e As PaintEventArgs)

    ' Create pen.
    Dim blackPen As New Pen(Color.Black, 3)

    ' Create rectangle.
    Dim rect As New Rectangle(0, 0, 200, 200)

    ' Draw rectangle to screen.
    e.Graphics.DrawRectangle(blackPen, rect)
End Sub

Remarks

Сведения о том, как нарисовать RectangleF, см. в разделе DrawRectangles(Pen, RectangleF[]).For information about how to draw a RectangleF, see DrawRectangles(Pen, RectangleF[]).

DrawRectangle(Pen, Int32, Int32, Int32, Int32)

Рисует прямоугольник, определяемый парой координат, шириной и высотой.Draws a rectangle specified by a coordinate pair, a width, and a height.

public:
 void DrawRectangle(System::Drawing::Pen ^ pen, int x, int y, int width, int height);
public void DrawRectangle (System.Drawing.Pen pen, int x, int y, int width, int height);
member this.DrawRectangle : System.Drawing.Pen * int * int * int * int -> unit
Public Sub DrawRectangle (pen As Pen, x As Integer, y As Integer, width As Integer, height As Integer)

Parameters

pen
Pen

Структура Pen, определяющая цвет, ширину и стиль прямоугольника.Pen that determines the color, width, and style of the rectangle.

x
Int32

Координата X верхнего левого угла прямоугольника для рисования.The x-coordinate of the upper-left corner of the rectangle to draw.

y
Int32

Координата Y верхнего левого угла прямоугольника для рисования.The y-coordinate of the upper-left corner of the rectangle to draw.

width
Int32

Ширина прямоугольника для рисования.Width of the rectangle to draw.

height
Int32

Высота прямоугольника для рисования.Height of the rectangle to draw.

Exceptions

Параметр pen равен null.pen is null.

Examples

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика событий Paint.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Код выполняет следующие действия.The code performs the following actions:

  • Создает черное перо.Creates a black pen.

  • Создает расположение и размер прямоугольника.Creates the position and size of a rectangle.

  • Отображает прямоугольник на экране.Draws the rectangle to the screen.

public:
   void DrawRectangleInt( PaintEventArgs^ e )
   {
      // Create pen.
      Pen^ blackPen = gcnew Pen( Color::Black,3.0f );

      // Create location and size of rectangle.
      int x = 0;
      int y = 0;
      int width = 200;
      int height = 200;

      // Draw rectangle to screen.
      e->Graphics->DrawRectangle( blackPen, x, y, width, height );
   }
public void DrawRectangleInt(PaintEventArgs e)
{
             
    // Create pen.
    Pen blackPen = new Pen(Color.Black, 3);
             
    // Create location and size of rectangle.
    int x = 0;
    int y = 0;
    int width = 200;
    int height = 200;
             
    // Draw rectangle to screen.
    e.Graphics.DrawRectangle(blackPen, x, y, width, height);
}
Public Sub DrawRectangleInt(ByVal e As PaintEventArgs)

    ' Create pen.
    Dim blackPen As New Pen(Color.Black, 3)

    ' Create location and size of rectangle.
    Dim x As Integer = 0
    Dim y As Integer = 0
    Dim width As Integer = 200
    Dim height As Integer = 200

    ' Draw rectangle to screen.
    e.Graphics.DrawRectangle(blackPen, x, y, width, height)
End Sub

Remarks

Сведения о том, как нарисовать RectangleF, см. в разделе DrawRectangles(Pen, RectangleF[]).For information about how to draw a RectangleF, see DrawRectangles(Pen, RectangleF[]).

DrawRectangle(Pen, Single, Single, Single, Single)

Рисует прямоугольник, определяемый парой координат, шириной и высотой.Draws a rectangle specified by a coordinate pair, a width, and a height.

public:
 void DrawRectangle(System::Drawing::Pen ^ pen, float x, float y, float width, float height);
public void DrawRectangle (System.Drawing.Pen pen, float x, float y, float width, float height);
member this.DrawRectangle : System.Drawing.Pen * single * single * single * single -> unit
Public Sub DrawRectangle (pen As Pen, x As Single, y As Single, width As Single, height As Single)

Parameters

pen
Pen

Структура Pen, определяющая цвет, ширину и стиль прямоугольника.A Pen that determines the color, width, and style of the rectangle.

x
Single

Координата X верхнего левого угла прямоугольника для рисования.The x-coordinate of the upper-left corner of the rectangle to draw.

y
Single

Координата Y верхнего левого угла прямоугольника для рисования.The y-coordinate of the upper-left corner of the rectangle to draw.

width
Single

Ширина прямоугольника для рисования.The width of the rectangle to draw.

height
Single

Высота прямоугольника для рисования.The height of the rectangle to draw.

Exceptions

Параметр pen равен null.pen is null.

Examples

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика событий Paint.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Код выполняет следующие действия.The code performs the following actions:

  • Создает черное перо.Creates a black pen.

  • Создает расположение и размер прямоугольника.Creates the position and size of a rectangle.

  • Отображает прямоугольник на экране.Draws the rectangle to the screen.

public:
   void DrawRectangleFloat( PaintEventArgs^ e )
   {
      // Create pen.
      Pen^ blackPen = gcnew Pen( Color::Black,3.0f );

      // Create location and size of rectangle.
      float x = 0.0F;
      float y = 0.0F;
      float width = 200.0F;
      float height = 200.0F;

      // Draw rectangle to screen.
      e->Graphics->DrawRectangle( blackPen, x, y, width, height );
   }
public void DrawRectangleFloat(PaintEventArgs e)
{
             
    // Create pen.
    Pen blackPen = new Pen(Color.Black, 3);
             
    // Create location and size of rectangle.
    float x = 0.0F;
    float y = 0.0F;
    float width = 200.0F;
    float height = 200.0F;
             
    // Draw rectangle to screen.
    e.Graphics.DrawRectangle(blackPen, x, y, width, height);
}
Public Sub DrawRectangleFloat(ByVal e As PaintEventArgs)

    ' Create pen.
    Dim blackPen As New Pen(Color.Black, 3)

    ' Create location and size of rectangle.
    Dim x As Single = 0.0F
    Dim y As Single = 0.0F
    Dim width As Single = 200.0F
    Dim height As Single = 200.0F

    ' Draw rectangle to screen.
    e.Graphics.DrawRectangle(blackPen, x, y, width, height)
End Sub

Remarks

Сведения о том, как нарисовать RectangleF, см. в разделе DrawRectangles(Pen, RectangleF[]).For information about how to draw a RectangleF, see DrawRectangles(Pen, RectangleF[]).

Applies to