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 值及其如何由属性解释

大小 是一种类似的结构,它使用相同的高度和宽度的隐喻。 但是,Rect 指定原点,而 Size 不指定。 通常,Rect 用于图形库 API, 并且大小 用于应用 UI 中的呈现和布局,尤其是自适应布局 (定位通常是自动) 。

应用于属性时 Rect 值的典型行为遵循以下原则:

  • 宽度高度 不能为负。
  • XY 可以是负值,因此 Rect 定义不在引用坐标框架之外,除非有额外的转换。
  • XY 可以是 0。 值 0 也对 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)
整顿 (点、点) FromPoints (Point、Point)
矩形 (点、大小) FromLocationAndSize (点、大小)
整型 (双、双、双、双、双) FromCoordinatesAndDimensions (Single、Single、Single、Single)
GetBottom (Rect)
Empty Empty
IsEmpty GetIsEmpty (Rect)
Left GetLeft (Rect)
Right GetRight (Rect)
顶部 GetTop (Rect)
包含点) ( 包含 (Rect、点)
等于 等于 (Rect、Rect)
截流 (直截) 相交 (Rect、Rect)
联合 (点) Union (Rect、Point)
Union (Rect) Union (Rect、Rect)

字段

Height

矩形的高度(以像素为单位)。

Width

矩形的宽度(以像素为单位)。

X

矩形左上角的 x 坐标。

Y

矩形左上角的 y 坐标。

适用于

另请参阅