导出 (0) 打印
全部展开
信息
您所需的主题如下所示。但此主题未包含在此库中。

矩形 Structure

包含表示矩形位置和大小的一组浮点数(四个)。

语法


var rect = {
    height : /* 你的值 */,
    width : /* 你的值 */,
    x : /* 你的值 */,
    y : /* 你的值 */
}


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


XAML Values

x

矩形左边的 x 坐标位置。

y

矩形上边的 y 坐标位置。

width

表示矩形的 Width 的值。

height

表示矩形的 Height 的值。

特性

[Version(0x06020000)]

成员

Rect结构 具有这些类型的成员:

构造函数

Rect结构 具有这些构造函数。

构造函数说明
Rect(Double, Double, Double, Double) [C#, VB]Initializes a Rect structure that has the specified x-coordinate, y-coordinate, width, and height.
Rect(float, float, float, float) [C++, JavaScript]Initializes a Rect structure that has the specified x-coordinate, y-coordinate, width, and height.
Rect(Point, Point) Initializes a Rect structure that is exactly large enough to contain the two specified points.
Rect(Point, Size) Initializes a Rect structure based on an origin and size.

 

字段

Rect结构 具有这些字段。

字段数据类型说明
Height | height [C++, JavaScript]

Number [JavaScript] | System.Single [.NET] | float32 [C++]

矩形的高度。

Width | width [C++, JavaScript]

Number [JavaScript] | System.Single [.NET] | float32 [C++]

矩形的宽度。

X | x [C++, JavaScript]

Number [JavaScript] | System.Single [.NET] | float32 [C++]

矩形左上角的 x 坐标。

Y | y [C++, JavaScript]

Number [JavaScript] | System.Single [.NET] | float32 [C++]

矩形左上角的 y 坐标。

 

方法

The Rect 结构 具有这些方法。 对于 C#、Visual Basic 和 C++,它还继承方法于Object 类.

方法说明
Contains Indicates whether the rectangle described by the Rect contains the specified point.
Equals(Object) [C#, VB]Determines whether the specified object is equal to a Rect.
Equals(Rect) [C#, VB]Compares two Rect structures for equality.
GetHashCode [C#, VB]Gets a hash code for this object.
Intersect Finds the intersection of the rectangle represented by the current Rect and the rectangle represented by the specified Rect, and stores the result as the current Rect.
IntersectsWith [C++, JavaScript]Indicates whether the specified rectangle intersects with the current rectangle.
ToString [C#, VB]Converts a Rect to a String representation.
ToString(IFormatProvider) [C#, VB]Creates a String representation of this Rect.
Union(Point) Expands the rectangle represented by the current Rect exactly enough to contain the specified point.
Union(Rect) Expands the rectangle represented by the current Rect exactly enough to contain the specified rectangle.

 

运算符

Rect结构 具有这些运算符。

运算符说明
Equality Compares two Rect structures for equality.
Inequality Compares two Rect structures for inequality.

 

属性

Rect结构 具有这些属性。

属性访问类型说明

Bottom

只读Gets the y-axis value of the bottom of the rectangle.

Empty

只读Gets a special value that represents a rectangle with no position or area.

Height

读/写Gets or sets the height of the rectangle.

IsEmpty

只读Gets a value that indicates whether the rectangle is the Empty rectangle.

Left

只读Gets the x-axis value of the left side of the rectangle.

Right

只读Gets the x-axis value of the right side of the rectangle.

Top

只读Gets the y-axis position of the top of the rectangle.

Width

读/写Gets or sets the width of the rectangle.

X

读/写Gets or sets the x-axis value of the left side of the rectangle.

Y

读/写Gets or sets the y-axis value of the top side of the rectangle.

 

备注

当应用于表示 UI 信息的属性时,Rect 的宽度和高度值表示与设备无关的像素。x 和 y 值表示主应用程序窗口的坐标空间中的点。

JavaScript:  在 JavaScript 中,Rect 是具有四个属性数据的对象:xywidthheight。除数据属性外,列在 Rect 成员列表中的 API 不适用于 JavaScript 编程。

关于 XAML 语法的说明

从技术上而言,Windows 运行时 XAML 分析规则允许对象特性使用。但是,不显示该用法,因为其不是常规情况。

可以使用空格而不是逗号作为值之间的分隔符。也允许使用混合的分隔符。

必须指定全部四个值。"0,0" 不是 "x,y" 的隐式默认值,也不存在可以分析为 XAML 特性语法所提供字符串中不足四个值的其他约定。

Rect 无法声明为 ResourceDictionary 中的资源,因为它不是可共享的类型。

矩形的投影和成员

如果要使用 Microsoft .NET 语言(C# 或 Microsoft Visual Basic)或 Visual C++ 组件扩展 (C++/CX),则 Rect 提供非数据成员,且其数据成员将作为读-写属性而不是字段来公开。

如果要使用 Windows 模板运行库 (WRL) 和 C++ 编程,则只有数据成员字段以 Rect 成员的形式存在,且不能使用成员表中列出的实用工具方法或属性。WRL 代码可以访问 RectHelper 静态类中可用的类似实用工具方法。

Rect 值以及如何用属性解释

Size 是使用指定高度和宽度的相同比喻的类似结构。不过,Rect 指定原点,而 Size 不指定原点。通常情况下,Rect 用于图形库 API,Size 用于应用 UI 中的呈现和布局。

由属性解释的 Rect 值的典型行为基于这些原则:

  • WidthHeight 值不能为负。
  • XY 可以为负值,此时得到的 Rect 定义不在屏幕上,但可以通过平移使它协调引用的帧之外。
  • XY 均可为 0。零值对 WidthHeight 也是有效的。但是,如果将其 WidthHeight 为 0 的 Rect 应用于 RectangleGeometry,将不会呈现结果 RectangleGeometry
  • 根据要求,XYWidthHeight 的值可以不是整数。 但是,通常使用整数值。当点位置和度量单位不使用子像素值时,XAML UI 定义将起作用且视觉效果最佳。

要求

最低支持客户端

Windows 8

最低支持服务器

Windows Server 2012

最低支持电话

Windows Phone 8

命名空间

Windows.Foundation
Windows::Foundation [C++]

元数据

Platform.winmd
Windows.winmd

程序集

System.Runtime.WindowsRuntime.dll

另请参见

Size
RectHelper

 

 

Microsoft 正在进行一项网上调查,以了解您对 MSDN 网站的意见。 如果您选择参加,我们将会在您离开 MSDN 网站时向您显示该网上调查。

是否要参加?
显示:
© 2015 Microsoft