Rectangle Структура

Определение

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

System.Drawing

Сборки:

netstandard.dll, 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)

Комментарии

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

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

Чтобы нарисовать заполненный 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)	Преобразует указанную RectangleFRectangle структуру в структуру путем округления RectangleF значений до следующих более высоких целых значений.
Contains(Int32, Int32)	Определяет, содержится ли указанная точка в этой Rectangle структуре.
Contains(Point)	Определяет, содержится ли указанная точка в этой Rectangle структуре.
Contains(Rectangle)	Определяет, содержится ли прямоугольная область, представленная rect полностью в этой Rectangle структуре.
Equals(Object)	Проверяет, Rectangle является ли obj структура одной и той же расположением и размером этой 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 структуру, представляющую пересечение двух других Rectangle структур. Если пересечения нет, возвращается пустое Rectangle .
Intersect(Rectangle)	Заменяет это Rectangle пересечением самого себя и указанного Rectangle.
IntersectsWith(Rectangle)	Определяет, пересекается ли этот прямоугольник с rect.
Offset(Int32, Int32)	Корректирует расположение этого прямоугольника по указанному количеству.
Offset(Point)	Корректирует расположение этого прямоугольника по указанному количеству.
Round(RectangleF)	Преобразует указанный в значение RectangleFRectangle путем округления RectangleF значений до ближайших целых чисел.
ToString()	Преобразует атрибуты этого Rectangle объекта в читаемую человеком строку.
Truncate(RectangleF)	Преобразует указанный RectangleF объект в значение путем усечения значений RectangleRectangleF .
Union(Rectangle, Rectangle)	Получает структуру Rectangle , содержащую объединение двух Rectangle структур.

Операторы

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