Rectangle 結構

定義

命名空間:

System.Drawing

組件:

System.Drawing.Primitives.dll

儲存四個為一組的整數，代表矩形的位置和大小。

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)

備註

矩形是由 屬性所代表的 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 座標，其為這個 Rectangle 結構之 Y 和 Height 屬性值的總和。
Height	取得或設定這個 Rectangle 結構的高度。
IsEmpty	測試這個 Rectangle 的所有數值屬性是否具有零值。
Left	取得這個 Rectangle 結構左邊緣的 X 座標。
Location	取得或設定這個 Rectangle 結構的左上角座標。
Right	取得 X 座標，其為這個 Rectangle 結構之 X 和 Width 屬性值的總和。
Size	取得或設定這個 Rectangle 的大小。
Top	取得這個 Rectangle 結構上邊緣的 Y 座標。
Width	取得或設定這個 Rectangle 結構的寬度。
X	取得或設定這個 Rectangle 結構的左上角 X 座標。
Y	取得或設定這個 Rectangle 結構的左上角 Y 座標。

方法

Ceiling(RectangleF)	藉由將 RectangleF 值捨入為下一個較大的整數值，來將指定的 RectangleF 結構轉換為 Rectangle 結構。
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 結構的位置或大小是否不同。