Rect 結構

定義

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

編輯

包含數位值，代表矩形的位置和大小。

public value class Rect

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.FoundationContract, 65536)]
struct Rect

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.FoundationContract), 65536)]
public struct Rect

var rect = {
x : /* Your value */,
y : /* Your value */,
width : /* Your value */,
height : /* Your value */
}

Public Structure Rect

<object property="x,y,width,height"/>
-or-
<object property="x y width height"/>

裝置系列	Windows 10 (已於 10.0.10240.0 引進)
API contract	Windows.Foundation.FoundationContract (已於 v1.0 引進)

套用至代表 UI 資訊的屬性時，Rect 值的寬度和高度值代表裝置無關的圖元。 x和y值具有不確定的參考框架， (取決於此值套用的方式) ，但它們通常代表主應用程式視窗座標空間中的點。

JAVAscript： 在 JavaScript 中，Rect 是具有四個資料成員的物件： x、 y、 width、 height。除了資料成員 (欄位) 以外，Rect 成員清單中所列的 API 不適用於 JavaScript 程式設計。

Windows 執行階段 XAML 剖析規則允許使用物件屬性。不過，不會顯示該使用量，因為它通常不會使用。

您可以使用空格，而不是逗號做為值之間的分隔符號。也允許混合分隔符號使用方式。

您必須指定這四個值。「0，0」不是「x，y」的隱含預設值，而且字串中沒有其他可以剖析小於 4 個元件的慣例。

Rect 元素無法宣告為 XAML ResourceDictionary 中的資源，因為 Rect 不是可共用的類型 (，如需詳細資訊，請參閱 ResourceDictionary 和 XAML 資源參考) 。

Size 是使用高度和寬度相同隱喻的類似結構。不過，Rect 會指定源點，而 Size 則不會。 Rect 通常用於圖形庫 API，而 Size 用於應用程式 UI 中的呈現和配置，特別是針對調適型配置， (位置通常是自動) 。

套用至屬性時，Rect 值的一般行為會遵循下列原則：

寬度和高度不可以是負數。
X 和 Y 可以是負數，除非有額外的轉譯，否則 Rect 定義超出參考座標框架的結果。
X 和 Y 可以是 0。 0 的值也適用于 Width 或 Height。不過， (如果Width或Height值為 0 的 Rect 套用至RectangleGeometry，則產生的 RectangleGeometry不會轉譯。)
X、 Y、 Width 和 Height 可以是允許值的非整數值。不過，您通常會使用整數值。當點位置和單位量值不使用子圖元值時，XAML UI 的行為最佳。

如果您使用 Microsoft .NET 語言 (C# 或 Microsoft Visual Basic) 或 Visual C++ 元件延伸模組， (C++/CX) ，則 Rect 有可用的非資料成員，而且其資料成員會公開為讀寫屬性，而非欄位。請參閱 .NET API 瀏覽器中的 Rect 。

如果您使用C++/WinRT或Windows 執行階段 C++ 樣板庫進行程式設計， (WRL) ，則只有資料成員欄位會以 Rect 的成員的形式存在，而且您無法使用 .NET 投影的公用程式方法或屬性。 C++ 程式碼可以存取來自 RectHelper 靜態類別的類似公用程式方法。

下表顯示 .NET 和 C++ 中可用的對等方法。

.NET (Rect)	C++ (RectHelper)
Rect (Point、Point)	FromPoints (Point、Point)
矩形 (點、大小)	FromLocationAndSize (Point， Size)
Rect (Double、Double、Double、Double)	FromCoordinatesAndDimensions (Single、Single、Single、Single)
下層	GetBottom (Rect)
Empty	Empty
IsEmpty	GetIsEmpty (Rect)
Left	GetLeft (Rect)
Right	GetRight (Rect)
前幾個	GetTop (Rect)
包含 (點)	包含 Rect、Point) (
等於	等於 (Rect、Rect)
交集 (Rect)	交集 (Rect、Rect)
等位 (點)	Union (Rect、Point)
等位 (Rect)	等位 (Rect、Rect)