Rectangle 结构

定义

存储一组整数,共四个,表示一个矩形的位置和大小。

public value class Rectangle : IEquatable<System::Drawing::Rectangle>
public value class 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>
public struct Rectangle
public struct Rectangle : IEquatable<System.Drawing.Rectangle>
[System.ComponentModel.TypeConverter(typeof(System.Drawing.RectangleConverter))]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public struct Rectangle
[<System.ComponentModel.TypeConverter("System.Drawing.RectangleConverter, System.Drawing, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
type Rectangle = struct
type Rectangle = struct
[<System.ComponentModel.TypeConverter(typeof(System.Drawing.RectangleConverter))>]
[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Serializable>]
type Rectangle = struct
Public Structure Rectangle
Implements IEquatable(Of Rectangle)
Public Structure Rectangle
继承
Rectangle
属性
实现

示例

下面的示例绘制一个矩形,其左上角位于 (10, 10)。 矩形的宽度为 100,高度为 50。 传递给 Pen 构造函数的第二个参数指示笔宽度为 5 个像素。

绘制矩形时,笔以矩形的边界为中心。 由于笔宽度为 5,因此矩形的边被绘制为 5 个像素宽,这样 1 个像素被绘制在边界本身上,2 个像素被绘制在内部,2 个像素被绘制在外部。 有关笔对齐的更多详细信息,请参阅如何:设置笔宽度和对齐方式

下图显示了生成的矩形。 虚线显示如果笔宽度为 1 个像素,矩形将在何处绘制。 矩形左上角的放大视图显示粗黑线以这些虚线为中心。

笔

该示例旨在与 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)

注解

矩形由其 WidthHeight和 左上角定义,由 Location 属性表示。

若要绘制一个矩形,需要一个 Graphics 对象和一个 Pen 对象。 Graphics 对象提供 DrawRectangle 方法,Pen 对象存储线的特征,例如颜色和宽度。 绘制矩形的单位由 PageUnit 用于绘制的图形对象的 和 PageScale 属性决定。 默认单位为像素。

若要绘制 Rectangle 填充颜色的 ,需要 一个 Graphics 对象和一个派生自 Brush 的对象,例如 SolidBrushLinearGradientBrush。 对象 Graphics 提供 FillRectangle 方法, Brush 对象提供颜色和填充信息。

对于更高级的形状,请使用 Region 对象。

构造函数

Rectangle(Int32, Int32, Int32, Int32)

用指定的位置和大小初始化 Rectangle 类的新实例。

Rectangle(Point, Size)

用指定的位置和大小初始化 Rectangle 类的新实例。

字段

Empty

表示其属性未被初始化的 Rectangle 结构。

属性

Bottom

获取 y 坐标,该坐标是此 Rectangle 结构的 YHeight 属性值之和。

Height

获取或设置此 Rectangle 结构的高度。

IsEmpty

测试此 Rectangle 的所有数值属性是否都具有零值。

Left

获取此 Rectangle 结构左边缘的 x 坐标。

Location

获取或设置此 Rectangle 结构左上角的坐标。

Right

获取 x 坐标,该坐标是此 Rectangle 结构的 XWidth 属性值之和。

Size

获取或设置此 Rectangle 的大小。

Top

获取此 Rectangle 结构上边缘的 y 坐标。

Width

获取或设置此 Rectangle 结构的宽度。

X

获取或设置此 Rectangle 结构左上角的 x 坐标。

Y

获取或设置此 Rectangle 结构左上角的 y 坐标。

方法

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 舍入到最近的整数值,将指定的 RectangleF 转换为 Rectangle

ToString()

将此 Rectangle 的特性转换为可读字符串。

Truncate(RectangleF)

通过截断 RectangleF 值,将指定的 RectangleF 转换为 Rectangle

Union(Rectangle, Rectangle)

获取包含两个 Rectangle 结构的交集的 Rectangle 结构。

运算符

Equality(Rectangle, Rectangle)

测试两个 Rectangle 结构的位置和大小是否相同。

Inequality(Rectangle, Rectangle)

测试两个 Rectangle 结构的位置或大小是否不同。

适用于