Rectangle Структура

Определение

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

System.Drawing

Сборка:

System.Drawing.Primitives.dll

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

public value class Rectangle : IEquatable<System::Drawing::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>

[<System.ComponentModel.TypeConverter("System.Drawing.RectangleConverter, System.Drawing, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
type Rectangle = struct

Public Structure Rectangle
Implements IEquatable(Of Rectangle)

Наследование

Object

ValueType

Rectangle

Атрибуты

TypeConverterAttribute

Реализации

IEquatable<Rectangle>

Примеры

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

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

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

Этот пример предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика 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)

Комментарии

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

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

Чтобы нарисовать заполненный цветом RectangleGraphics , вам потребуется объект и объект, производный от 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 по положению или размеру.