Rectangle Структура

Определение

Содержит набор из четырех целых чисел, определяющих расположение и размер прямоугольника.

public value class Rectangle : IEquatable<System::Drawing::Rectangle>
public value class Rectangle
[System.ComponentModel.TypeConverter("System.Drawing.RectangleConverter, System.Drawing, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public struct Rectangle : IEquatable<System.Drawing.Rectangle>
public struct Rectangle
public struct Rectangle : IEquatable<System.Drawing.Rectangle>
[System.ComponentModel.TypeConverter(typeof(System.Drawing.RectangleConverter))]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public struct Rectangle
[<System.ComponentModel.TypeConverter("System.Drawing.RectangleConverter, System.Drawing, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
type Rectangle = struct
type Rectangle = struct
[<System.ComponentModel.TypeConverter(typeof(System.Drawing.RectangleConverter))>]
[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Serializable>]
type Rectangle = struct
Public Structure Rectangle
Implements IEquatable(Of Rectangle)
Public Structure Rectangle
Наследование
Rectangle
Атрибуты
Реализации

Примеры

В приведенном ниже примере рисуется прямоугольник с верхним левым углом в точке (10, 10). Прямоугольник имеет ширину 100 и высоту 50. Второй аргумент, переданный в конструктор Pen, указывает, что ширина пера равна 5 пикселям.

Когда прямоугольник рисуется, перо находится по центру границы прямоугольника. Так как ширина пера равна 5, стороны прямоугольника рисуются толщиной в 5 пикселей, поэтому 1 пиксель рисуется на самой границе, 2 — внутри и еще 2 — снаружи. Дополнительные сведения о выравнивании пера см. в статье Практическое руководство. Задание толщины и выравнивания пера.

Нарисованный прямоугольник показан на рисунке ниже. Пунктирные линии показывают, где был бы нарисован прямоугольник, если ширина пера была бы равна одному пикселю. Увеличенный вид верхнего левого угла прямоугольника показывает, что толстые черные линии расположены по центру этих пунктирных линий.

Перья

Этот пример предназначен для использования с Windows Forms и требуется PaintEventArgs e, который является параметром обработчика Paint событий.

Pen blackPen = new Pen(Color.FromArgb(255, 0, 0, 0), 5);
e.Graphics.DrawRectangle(blackPen, 10, 10, 100, 50);
Dim blackPen As New Pen(Color.FromArgb(255, 0, 0, 0), 5)
e.Graphics.DrawRectangle(blackPen, 10, 10, 100, 50)

Комментарии

Прямоугольник определяется его WidthHeightи верхним левым углом, представленным свойствомLocation.

Для рисования прямоугольников требуется объект Graphics и объект Pen. Объект Graphics предоставляет метод DrawRectangle, а объект Pen хранит в себе такие свойства линии, как цвет и толщина. Единицы рисования прямоугольника определяются свойствами PageUnit PageScale графического объекта, используемого для рисования. Единица измерения по умолчанию — пиксели.

Чтобы нарисовать заполненный Rectangle цветом Graphics , требуется объект и объект, производный от Brush такого типа SolidBrush или LinearGradientBrush. Объект Graphics предоставляет FillRectangle метод, а Brush объект предоставляет сведения о цвете и заливки.

Для более сложных фигур используйте Region объект.

Конструкторы

Rectangle(Int32, Int32, Int32, Int32)

Инициализирует новый экземпляр класса Rectangle заданным расположением и размером.

Rectangle(Point, Size)

Инициализирует новый экземпляр класса Rectangle заданным расположением и размером.

Поля

Empty

Представляет структуру Rectangle, свойства которой не инициализированы.

Свойства

Bottom

Возвращает координату по оси Y, являющуюся суммой значений свойств Y и Height данной структуры Rectangle.

Height

Возвращает или задает высоту в структуре Rectangle.

IsEmpty

Проверяет, все ли числовые свойства этого прямоугольника Rectangle имеют нулевые значения.

Left

Возвращает координату по оси X левого края структуры Rectangle.

Location

Возвращает или задает координаты левого верхнего угла структуры Rectangle.

Right

Возвращает координату по оси X, являющуюся суммой значений свойств X и Width данной структуры Rectangle.

Size

Возвращает или задает размер этого объекта Rectangle.

Top

Возвращает координату по оси Y верхнего края структуры Rectangle.

Width

Возвращает или задает ширину структуры Rectangle.

X

Возвращает или задает координату по оси X левого верхнего угла структуры Rectangle.

Y

Возвращает или задает координату по оси Y левого верхнего угла структуры Rectangle.

Методы

Ceiling(RectangleF)

Преобразует указанную структуру RectangleF в структуру Rectangle, округляя значения RectangleF до ближайшего большего целого числа.

Contains(Int32, Int32)

Определяет, содержится ли заданная точка в структуре Rectangle.

Contains(Point)

Определяет, содержится ли заданная точка в структуре Rectangle.

Contains(Rectangle)

Определяет, содержится ли вся прямоугольная область, представленная параметром rect, в структуре Rectangle.

Equals(Object)

Проверяет, является ли obj структурой Rectangle с таким же расположением и размером, что и структура Rectangle.

Equals(Rectangle)

Указывает, равен ли текущий объект другому объекту того же типа.

FromLTRB(Int32, Int32, Int32, Int32)

Создает структуру Rectangle с заданным положением краев.

GetHashCode()

Возвращает хэш-код данной структуры Rectangle. Дополнительные сведения об использовании хэш-кодов см. в разделе GetHashCode().

Inflate(Int32, Int32)

Увеличивает данный объект Rectangle на заданную величину.

Inflate(Rectangle, Int32, Int32)

Создает и возвращает увеличенную копию заданной структуры Rectangle. Копия увеличивается на заданную величину. Исходная структура Rectangle остается без изменений.

Inflate(Size)

Увеличивает данный объект Rectangle на заданную величину.

Intersect(Rectangle)

Заменяет данный объект Rectangle его пересечением с указанным прямоугольником Rectangle.

Intersect(Rectangle, Rectangle)

Возвращает третью структуру Rectangle, представляющую собой пересечение двух других структур Rectangle. Если пересечение отсутствует, возвращается пустая структура Rectangle.

IntersectsWith(Rectangle)

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

Offset(Int32, Int32)

Изменяет положение этого прямоугольника на указанную величину.

Offset(Point)

Изменяет положение этого прямоугольника на указанную величину.

Round(RectangleF)

Преобразует указанный RectangleF в Rectangle, округляя значения RectangleF до ближайших целых чисел.

ToString()

Преобразует атрибуты этого прямоугольника Rectangle в удобную для восприятия строку.

Truncate(RectangleF)

Преобразует указанный объект RectangleF в Rectangle путем усечения значений RectangleF.

Union(Rectangle, Rectangle)

Возвращает структуру Rectangle, содержащую объединение двух структур Rectangle.

Операторы

Equality(Rectangle, Rectangle)

Проверяет, имеют ли две структуры Rectangle одинаковое положение и размер.

Inequality(Rectangle, Rectangle)

Проверяет, различаются ли две структуры Rectangle по положению или размеру.

Применяется к