Rectangle 結構

定義

命名空間:

System.Drawing

組件:

System.Drawing.Primitives.dll

來源:

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 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)

備註

矩形是由 屬性所Location代表的Width、 Height和 左上角所定義。

若要繪製矩形，您需要 物件 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 結構的位置或大小是否不同。