共用方式為


Rect 結構

定義

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

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"/>

繼承
Rect
屬性

Windows 需求

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

備註

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

JAVAscript: 在 JavaScript 中,Rect 是具有四個資料成員的物件: xywidthheight。 除了資料成員 (欄位) 以外,Rect 成員清單中所列的 API 不適用於 JavaScript 程式設計。

XAML 語法注意事項

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

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

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

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

Rect 值及其如何由屬性解譯

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

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

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

語言投影和 Rect 的成員

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

如果您使用C++/WinRTWindows 執行階段 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)

欄位

Height

矩形的高度 (以像素為單位)。

Width

矩形的寬度 (以像素為單位)。

X

矩形左上角的 X 座標。

Y

矩形左上角的 Y 座標。

適用於

另請參閱