Rectangle Структура

Определение

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

System.Drawing

Сборка:

System.Drawing.Primitives.dll

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

Rectangle.cs

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

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 свойства графического объекта, используемого для рисования. Единица по умолчанию — пиксели.

Чтобы нарисовать 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 структуры в расположении или размере.