Graphics.DrawRectangle Метод

Определение

Пространство имен:

System.Drawing

Сборка:

System.Drawing.Common.dll

Пакет:

System.Drawing.Common v8.0.0

Рисует прямоугольник, определяемый парой координат, шириной и высотой.

Перегрузки

DrawRectangle(Pen, Int32, Int32, Int32, Int32)	Рисует прямоугольник, определяемый парой координат, шириной и высотой.
DrawRectangle(Pen, Single, Single, Single, Single)	Рисует прямоугольник, определяемый парой координат, шириной и высотой.
DrawRectangle(Pen, RectangleF)	Рисует контур указанного прямоугольника.
DrawRectangle(Pen, Rectangle)	Рисует прямоугольник, определяемый структурой Rectangle.

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

Исходный код:

Graphics.cs

Рисует прямоугольник, определяемый парой координат, шириной и высотой.

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)

Параметры

pen

Pen

Структура Pen, определяющая цвет, ширину и стиль прямоугольника.

x

Int32

Координата X верхнего левого угла прямоугольника для рисования.

y

Int32

Координата Y верхнего левого угла прямоугольника для рисования.

width

Int32

Ширина прямоугольника для рисования.

height

Int32

Высота прямоугольника для рисования.

Исключения

ArgumentNullException

pen имеет значение null.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика Paint событий. Код выполняет следующие действия.

• Создает черную ручку.

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

• Рисует прямоугольник на экране.

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

Комментарии

Сведения о том, как нарисовать RectangleF, см. в разделе DrawRectangles(Pen, RectangleF[]).

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

Исходный код:

Graphics.cs

Рисует прямоугольник, определяемый парой координат, шириной и высотой.

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)

Параметры

pen

Pen

Структура Pen, определяющая цвет, ширину и стиль прямоугольника.

x

Single

Координата X верхнего левого угла прямоугольника для рисования.

y

Single

Координата Y верхнего левого угла прямоугольника для рисования.

width

Single

Ширина прямоугольника для рисования.

height

Single

Высота прямоугольника для рисования.

Исключения

ArgumentNullException

pen имеет значение null.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика Paint событий. Код выполняет следующие действия.

• Создает черную ручку.

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

• Рисует прямоугольник на экране.

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

Комментарии

Сведения о том, как нарисовать RectangleF, см. в разделе DrawRectangles(Pen, RectangleF[]).

DrawRectangle(Pen, RectangleF)

Исходный код:

Graphics.cs

Рисует контур указанного прямоугольника.

public:
 void DrawRectangle(System::Drawing::Pen ^ pen, System::Drawing::RectangleF rect);

public void DrawRectangle (System.Drawing.Pen pen, System.Drawing.RectangleF rect);

member this.DrawRectangle : System.Drawing.Pen * System.Drawing.RectangleF -> unit

Public Sub DrawRectangle (pen As Pen, rect As RectangleF)

Параметры

pen

Pen

Перо, определяющее цвет, ширину и стиль прямоугольника.

rect

RectangleF

Рисуемый прямоугольник.

DrawRectangle(Pen, Rectangle)

Исходный код:

Graphics.cs

Рисует прямоугольник, определяемый структурой Rectangle.

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)

Параметры

pen

Pen

Структура Pen, определяющая цвет, ширину и стиль прямоугольника.

rect

Rectangle

Структура Rectangle, представляющая прямоугольник для рисования.

Исключения

ArgumentNullException

pen имеет значение null.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика Paint событий. Код выполняет следующие действия.

• Создает черную ручку.

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

• Рисует прямоугольник на экране.

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

Комментарии

Сведения о том, как нарисовать RectangleF, см. в разделе DrawRectangles(Pen, RectangleF[]).