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 值具有不确定的参照系， (该值取决于) 如何应用此值，但它们通常表示main应用窗口坐标空间中的一个点。

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 值的典型行为遵循以下原则：

Width 和 Height 不能为负数。
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)
矩形 (点、点)	FromPoints (Point、Point)
矩形 (点、大小)	FromLocationAndSize (Point、Size)
矩形 (Double、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、Rect)
交叉 (矩形)	相交 (矩形、直截)
联合 (点)	联合 (矩形，点)
联合 (矩形)	联合 (Rect、Rect)