Rectangle 结构

定义

命名空间:

System.Drawing

程序集:

netstandard.dll, System.Drawing.Primitives.dll

Source:

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 窗体一起使用，它需要 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 和 Height 的 Rectangle y 坐标。
Height	获取或设置此 Rectangle 结构的高度。
IsEmpty	测试此 Rectangle 值的所有数值属性是否为零。
Left	获取此 Rectangle 结构的左边缘的 x 坐标。
Location	获取或设置此 Rectangle 结构的左上角的坐标。
Right	获取此Rectangle结构的总X和Width的 x 坐标。
Size	获取或设置此 Rectangle大小。
Top	获取此 Rectangle 结构的上边缘的 y 坐标。
Width	获取或设置此 Rectangle 结构的宽度。
X	获取或设置此 Rectangle 结构的左上角的 x 坐标。
Y	获取或设置此 Rectangle 结构的左上角的 y 坐标。

方法

名称	说明
Ceiling(RectangleF)	通过将值舍入到下一Rectangle个更高的整数值，将RectangleF指定的RectangleF结构转换为结构。
Contains(Int32, Int32)	确定指定点是否包含在此 Rectangle 结构中。
Contains(Point)	确定指定点是否包含在此 Rectangle 结构中。
Contains(Rectangle)	确定所表示 rect 的矩形区域是否完全包含在此 Rectangle 结构中。
Equals(Object)	测试此Rectangle结构的位置和大小Rectangle是否obj相同。
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)	通过将值舍入到Rectangle最接近的整数值，将RectangleF指定的RectangleF值转换为 a。
ToString()	将此属性 Rectangle 的属性转换为可读字符串。
Truncate(RectangleF)	通过截断RectangleF值将指定RectangleF值转换为指定Rectangle值。
Union(Rectangle, Rectangle)	获取包含两Rectangle个Rectangle结构的并集的结构。

运营商

名称	说明
Equality(Rectangle, Rectangle)	测试两个 Rectangle 结构是否具有相同的位置和大小。
Inequality(Rectangle, Rectangle)	测试两个 Rectangle 结构在位置或大小上是否存在差异。