Rectangle Rectangle Rectangle Rectangle Struct

Определение

Содержит набор из четырех целых чисел, определяющих расположение и размер прямоугольника.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)
Наследование
Атрибуты
Реализации

Примеры

В следующем примере демонстрируется рисование прямоугольника с верхним левым углом в точке (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. Дополнительные сведения о выравнивании пера см. в разделе как Задайте ширину и выравниваниепера.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 e, что 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. Объект предоставляет метод, а Pen объект сохраняет функции линии, такие как цвет и ширина. DrawRectangle GraphicsThe 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 необходим объект и SolidBrush объект, производный от Brush , например или LinearGradientBrush.To draw a Rectangle filled with color, you need a Graphics object and an object derived from Brush such as SolidBrush or LinearGradientBrush. Объект предоставляет метод, а Brush объект предоставляет сведения о цвете и заполнении. FillRectangle GraphicsThe 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(Point, Size) Rectangle(Point, Size) Rectangle(Point, Size) Rectangle(Point, Size)

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

Rectangle(Int32, Int32, Int32, Int32) Rectangle(Int32, Int32, Int32, Int32) Rectangle(Int32, Int32, Int32, Int32) Rectangle(Int32, Int32, Int32, Int32)

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

Поля

Empty Empty Empty Empty

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

Свойства

Bottom Bottom Bottom 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 Height Height Height

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

IsEmpty IsEmpty IsEmpty IsEmpty

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

Left Left Left Left

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

Location Location Location Location

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

Right Right Right Right

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

Size Size Size Size

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

Top Top Top Top

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

Width Width Width Width

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

X X X X

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

Y Y Y Y

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

Методы

Ceiling(RectangleF) Ceiling(RectangleF) Ceiling(RectangleF) 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(Point) Contains(Point) Contains(Point) Contains(Point)

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

Contains(Rectangle) Contains(Rectangle) Contains(Rectangle) Contains(Rectangle)

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

Contains(Int32, Int32) Contains(Int32, Int32) Contains(Int32, Int32) Contains(Int32, Int32)

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

Equals(Rectangle) Equals(Rectangle) Equals(Rectangle) Equals(Rectangle)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

FromLTRB(Int32, Int32, Int32, Int32) FromLTRB(Int32, Int32, Int32, Int32) FromLTRB(Int32, Int32, Int32, Int32) FromLTRB(Int32, Int32, Int32, Int32)

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

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

Inflate(Size) Inflate(Size) Inflate(Size) Inflate(Size)

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

Inflate(Int32, Int32) Inflate(Int32, Int32) Inflate(Int32, Int32) Inflate(Int32, Int32)

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

Inflate(Rectangle, Int32, Int32) Inflate(Rectangle, Int32, Int32) Inflate(Rectangle, Int32, Int32) 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.

Intersect(Rectangle, Rectangle) Intersect(Rectangle, Rectangle) Intersect(Rectangle, 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.

Intersect(Rectangle) Intersect(Rectangle) Intersect(Rectangle) Intersect(Rectangle)

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

IntersectsWith(Rectangle) IntersectsWith(Rectangle) IntersectsWith(Rectangle) IntersectsWith(Rectangle)

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

Offset(Point) Offset(Point) Offset(Point) Offset(Point)

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

Offset(Int32, Int32) Offset(Int32, Int32) Offset(Int32, Int32) Offset(Int32, Int32)

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

Round(RectangleF) Round(RectangleF) Round(RectangleF) Round(RectangleF)

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

ToString() ToString() ToString() ToString()

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

Truncate(RectangleF) Truncate(RectangleF) Truncate(RectangleF) Truncate(RectangleF)

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

Union(Rectangle, Rectangle) Union(Rectangle, Rectangle) Union(Rectangle, Rectangle) Union(Rectangle, Rectangle)

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

Операторы

Equality(Rectangle, Rectangle) Equality(Rectangle, Rectangle) Equality(Rectangle, Rectangle) Equality(Rectangle, Rectangle)

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

Inequality(Rectangle, Rectangle) Inequality(Rectangle, Rectangle) Inequality(Rectangle, Rectangle) Inequality(Rectangle, Rectangle)

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

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