Rectangle Структура

Определение

Содержит набор из четырех целых чисел, определяющих расположение и размер прямоугольника.Stores a set of four integers that represent the location and size of a rectangle.

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

Примеры

В следующем примере демонстрируется рисование прямоугольника с верхним левым углом в точке (10, 10).The following example draws a rectangle with its upper-left corner at (10, 10). Ширина прямоугольника равна 100 и высоте 50.The rectangle has a width of 100 and a height of 50. Второй аргумент, передаваемый конструктору Pen, указывает, что ширина пера равна 5 пикселам.The second argument passed to the Pen constructor indicates that the pen width is 5 pixels.

При прорисовке прямоугольника перо центрируется по границе прямоугольника.When the rectangle is drawn, the pen is centered on the rectangle's boundary. Так как ширина пера равна 5, стороны прямоугольника выводятся в ширину 5 пикселей, то есть 1 пиксель рисуется на границе, 2 пиксела нарисованы внутри, а 2 пиксела — снаружи.Because the pen width is 5, the sides of the rectangle are drawn 5 pixels wide, such that 1 pixel is drawn on the boundary itself, 2 pixels are drawn on the inside, and 2 pixels are drawn on the outside. Дополнительные сведения о выравнивании пера см. в разделе [How: Задайте ширину пера и выравнивание @ no__t-0.For more details on pen alignment, see How to: Set Pen Width and Alignment.

На следующем рисунке показан итоговый прямоугольник.The following illustration shows the resulting rectangle. Пунктирные линии показывают, где будет нарисован прямоугольник, если толщина пера была равна одному пикселю.The dotted lines show where the rectangle would have been drawn if the pen width had been one pixel. Увеличенное представление верхнего левого угла прямоугольника показывает, что толстые черные линии центрируются по пунктирным линиям.The enlarged view of the upper-left corner of the rectangle shows that the thick black lines are centered on those dotted lines.

РучкойPens

Пример предназначен для использования с Windows Forms и требует PaintEventArgs @ no__t-1, который является параметром обработчика событий Paint.The example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler.

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.A rectangle is defined by its Width, Height, and upper-left corner represented by the Location property.

Для рисования прямоугольников необходим объект Graphics и объект Pen.To draw rectangles, you need a Graphics object and a Pen object. Объект Graphics предоставляет метод DrawRectangle, а объект Pen хранит функции линии, такие как цвет и ширина.The Graphics object provides the DrawRectangle method, and the Pen object stores features of the line, such as color and width. Единицы, которые рисует прямоугольник, определяются свойствами PageUnit и PageScale графического объекта, используемого для рисования.The units the rectangle is drawn in is determined by the PageUnit and PageScale properties of the graphics object used for drawing. Единицей по умолчанию являются пиксели.The default unit is pixels.

Чтобы нарисовать Rectangle, заполненный цветом, необходим объект Graphics и объект, производный от Brush, например SolidBrush или LinearGradientBrush.To draw a Rectangle filled with color, you need a Graphics object and an object derived from Brush such as SolidBrush or LinearGradientBrush. Объект Graphics предоставляет метод FillRectangle, а объект Brush предоставляет сведения о цвете и заполнении.The Graphics object provides the FillRectangle method and the Brush object provides the color and fill information.

Для более сложных фигур используйте объект Region.For more advanced shapes, use a Region object.

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

Rectangle(Int32, Int32, Int32, Int32)

Инициализирует новый экземпляр класса Rectangle заданным расположением и размером.Initializes a new instance of the Rectangle class with the specified location and size.

Rectangle(Point, Size)

Инициализирует новый экземпляр класса Rectangle заданным расположением и размером.Initializes a new instance of the Rectangle class with the specified location and size.

Поля

Empty

Представляет структуру Rectangle, свойства которой не инициализированы.Represents a Rectangle structure with its properties left uninitialized.

Свойства

Bottom

Возвращает координату по оси Y, являющуюся суммой значений свойств Y и Height данной структуры Rectangle.Gets the y-coordinate that is the sum of the Y and Height property values of this Rectangle structure.

Height

Возвращает или задает высоту в структуре Rectangle.Gets or sets the height of this Rectangle structure.

IsEmpty

Проверяет, все ли числовые свойства этого прямоугольника Rectangle имеют нулевые значения.Tests whether all numeric properties of this Rectangle have values of zero.

Left

Возвращает координату по оси X левого края структуры Rectangle.Gets the x-coordinate of the left edge of this Rectangle structure.

Location

Возвращает или задает координаты левого верхнего угла структуры Rectangle.Gets or sets the coordinates of the upper-left corner of this Rectangle structure.

Right

Возвращает координату по оси X, являющуюся суммой значений свойств X и Width данной структуры Rectangle.Gets the x-coordinate that is the sum of X and Width property values of this Rectangle structure.

Size

Возвращает или задает размер этого объекта Rectangle.Gets or sets the size of this Rectangle.

Top

Возвращает координату по оси Y верхнего края структуры Rectangle.Gets the y-coordinate of the top edge of this Rectangle structure.

Width

Возвращает или задает ширину структуры Rectangle.Gets or sets the width of this Rectangle structure.

X

Возвращает или задает координату по оси X левого верхнего угла структуры Rectangle.Gets or sets the x-coordinate of the upper-left corner of this Rectangle structure.

Y

Возвращает или задает координату по оси Y левого верхнего угла структуры Rectangle.Gets or sets the y-coordinate of the upper-left corner of this Rectangle structure.

Методы

Ceiling(RectangleF)

Преобразует указанную структуру RectangleF в структуру Rectangle, округляя значения RectangleF до ближайшего большего целого числа.Converts the specified RectangleF structure to a Rectangle structure by rounding the RectangleF values to the next higher integer values.

Contains(Int32, Int32)

Определяет, содержится ли заданная точка в структуре Rectangle.Determines if the specified point is contained within this Rectangle structure.

Contains(Point)

Определяет, содержится ли заданная точка в структуре Rectangle.Determines if the specified point is contained within this Rectangle structure.

Contains(Rectangle)

Определяет, содержится ли вся прямоугольная область, представленная параметром rect, в структуре Rectangle.Determines if the rectangular region represented by rect is entirely contained within this Rectangle structure.

Equals(Object)

Проверяет, является ли obj структурой Rectangle с таким же расположением и размером, что и структура Rectangle.Tests whether obj is a Rectangle structure with the same location and size of this Rectangle structure.

Equals(Rectangle)
FromLTRB(Int32, Int32, Int32, Int32)

Создает структуру Rectangle с заданным положением краев.Creates a Rectangle structure with the specified edge locations.

GetHashCode()

Возвращает хэш-код данной структуры Rectangle.Returns the hash code for this Rectangle structure. Дополнительные сведения об использовании хэш-кодов см. в разделе GetHashCode().For information about the use of hash codes, see GetHashCode() .

Inflate(Int32, Int32)

Увеличивает данный объект Rectangle на заданную величину.Enlarges this Rectangle by the specified amount.

Inflate(Rectangle, Int32, Int32)

Создает и возвращает увеличенную копию заданной структуры Rectangle.Creates and returns an enlarged copy of the specified Rectangle structure. Копия увеличивается на заданную величину.The copy is enlarged by the specified amount. Исходная структура Rectangle остается без изменений.The original Rectangle structure remains unmodified.

Inflate(Size)

Увеличивает данный объект Rectangle на заданную величину.Enlarges this Rectangle by the specified amount.

Intersect(Rectangle)

Заменяет данный объект Rectangle его пересечением с указанным прямоугольником Rectangle.Replaces this Rectangle with the intersection of itself and the specified Rectangle.

Intersect(Rectangle, Rectangle)

Возвращает третью структуру Rectangle, представляющую собой пересечение двух других структур Rectangle.Returns a third Rectangle structure that represents the intersection of two other Rectangle structures. Если пересечение отсутствует, возвращается пустая структура Rectangle.If there is no intersection, an empty Rectangle is returned.

IntersectsWith(Rectangle)

Определяет, пересекается ли данный прямоугольник с прямоугольником rect.Determines if this rectangle intersects with rect.

Offset(Int32, Int32)

Изменяет положение этого прямоугольника на указанную величину.Adjusts the location of this rectangle by the specified amount.

Offset(Point)

Изменяет положение этого прямоугольника на указанную величину.Adjusts the location of this rectangle by the specified amount.

Round(RectangleF)

Преобразует указанный RectangleF в Rectangle, округляя значения RectangleF до ближайших целых чисел.Converts the specified RectangleF to a Rectangle by rounding the RectangleF values to the nearest integer values.

ToString()

Преобразует атрибуты этого прямоугольника Rectangle в удобную для восприятия строку.Converts the attributes of this Rectangle to a human-readable string.

Truncate(RectangleF)

Преобразует указанный объект RectangleF в Rectangle путем усечения значений RectangleF.Converts the specified RectangleF to a Rectangle by truncating the RectangleF values.

Union(Rectangle, Rectangle)

Возвращает структуру Rectangle, содержащую объединение двух структур Rectangle.Gets a Rectangle structure that contains the union of two Rectangle structures.

Операторы

Equality(Rectangle, Rectangle)

Проверяет, имеют ли две структуры Rectangle одинаковое положение и размер.Tests whether two Rectangle structures have equal location and size.

Inequality(Rectangle, Rectangle)

Проверяет, различаются ли две структуры Rectangle по положению или размеру.Tests whether two Rectangle structures differ in location or size.

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