信息
您所需的主题如下所示。但此主题未包含在此库中。

Rect 结构

2013/12/13

描述矩形的宽度、高度和原点。

Namespace:  System.Windows
程序集:  System.Windows(位于 System.Windows.dll 中)
XMLNS for XAML: 未映射到 xmlns。

public struct Rect : IFormattable
<Rect ...>x,y,width,height</Rect>
<object property="x,y,width,height"/>

XAML 值

x

矩形左边的 x 坐标位置。

y

矩形上边的 y 坐标位置。

宽度

表示矩形的 Width 的值。

高度

表示矩形的 Height 的值。

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

  • 必须指定全部四个值。0,0 不是 x,y 的隐式默认值,也不存在可以分析字符串中不足四个值的其他约定。

  • X andY 可以为负值。 widthheight 可以为负值,此时呈现 widthheight 所适用的方向与正值时相反。请参见“备注”。

Rect 类型公开以下成员。

  名称说明
公共方法Rect(Point, Point)初始化 Rect 结构,此结构的大小刚好足以包含两个指定的点。
公共方法Rect(Point, Size)基于原点和大小初始化 Rect 结构。
公共方法Rect(Double, Double, Double, Double)初始化 Rect 结构,此结构具有指定的 x 坐标、y 坐标、宽度和高度。
返回顶部

  名称说明
公共属性Bottom获取矩形底边的 y 轴值。
公共属性静态成员Empty获取一个特殊值,该值表示没有位置或区域的矩形。
公共属性Height获取或设置矩形的高度。
公共属性IsEmpty获取一个值,该值指示矩形是否为 Empty 矩形。
公共属性Left获取矩形左边的 x 轴值。
公共属性Right获取矩形右边的 x 轴值。
公共属性Top获取矩形顶边的 y 轴位置。
公共属性Width获取或设置矩形的宽度。
公共属性X获取或设置矩形左边的 x 轴值。
公共属性Y获取或设置矩形顶边的 y 轴值。
返回顶部

  名称说明
公共方法Contains指示 Rect 所描述的矩形是否包含指定的点。
公共方法Equals(Object)指示指定对象是否与当前的 Rect 相等。 (重写 ValueType.Equals(Object)。)
公共方法Equals(Rect)指示指定的 Rect 是否与当前的 Rect 相等。
受保护的方法Finalize允许 Object 在垃圾回收器回收该对象之前尝试释放资源并执行其他清理操作。 (从 Object 继承。)
公共方法GetHashCode创建 Rect 的哈希代码。 (重写 ValueType.GetHashCode()。)
公共方法GetType获取当前实例的 Type (从 Object 继承。)
公共方法Intersect查找当前 Rect 所表示的矩形和指定 Rect 所表示的矩形的交集,并将结果存储为当前 Rect
受保护的方法MemberwiseClone创建当前 Object 的浅表副本。 (从 Object 继承。)
公共方法ToString()返回 Rect 结构的字符串表示形式。 (重写 ValueType.ToString()。)
公共方法ToString(IFormatProvider)使用指定的格式提供程序返回矩形的字符串表示形式。
公共方法Union(Point)放大当前 Rect 所表示的矩形,使其刚好足以包含指定的点。
公共方法Union(Rect)放大当前 Rect 所表示的矩形,使其刚好足以包含指定的矩形。
返回顶部

  名称说明
公共运算符静态成员Equality比较两个 Rect 结构是否相等。
公共运算符静态成员Inequality比较两个 Rect 结构是否不相等。
返回顶部

  名称说明
显式接口实现私有方法IFormattable.ToString基础结构。 有关此成员的说明,请参见 ToString
返回顶部

Size 是使用指定高度和宽度的相同比喻的类似结构。不过,Rect 指定原点,而 Size 不指定原点。一般而言,Rect 用于与图形表示有关的 API,而 Size 用于与 UI 表示和布局有关的 API。

不要混淆 RectRectangleRect 是一种常见的数据结构,用于将矩形区域指定为某些属性的一个值。但 Rect 本身不具有任何含义,或者不具有任何直接的 UI 含义。Rect 的含义完全取决于将它处理为某个特定属性的值的方式。相反,RectangleShape,因此是 UIElement。可以将 Rectangle 指定为 XAML 元素,还可以实例化在 UI 中显示、可以处理输入事件的矩形形状。

值的编程上限不是 PositiveInfinity,而是一个由 Windows Phone 本机代码强制实施的较低数字(约为 1,000,000)。

尽管 Rect 的属性值的类型为 Double,通常还应使用整数值。

Rect 的属性在 Windows Phone 的 XAML 中不支持特性语法。在 XAML 中,应始终通过以下用法之一指定 Rect 类型属性:

  • XAML 特性用法,它推断使用 Rect 类型的属性,并使用类型转换器来将特性字符串处理成 Rect 的特定值。

  • 属性元素用法,包含 Rect 对象元素。对于该对象元素,使用初始化文本设置 Rect 属性,如 XAML 对象元素用法中所示。

如果您指定 Rect 用作资源,则使用对象元素用法并使用初始化文本设置 Rect 属性。

说明注意:

widthheight 可以为负值(如果在 XAML 中作为特性字符串的一部分指定),此时高度或宽度应用的方向与正值时相反。例如,如果 height 为 -20,将生成 Rect,其中 XY 点此时为左下角。但是,托管 API 中的 Rect 构造函数不允许 widthheight 为负值。应调整 xywidthheight 的坐标引用,以便可以使用非负数的 widthheight 值指定 Rect

以下有关 Rect 值的说明适用于在 XAML 中创建的 Rect 以及在代码中构造的 Rect

  • XY 可以为负值,此时得到的 Rect 定义不在屏幕上,但可以通过平移使它出现在屏幕上。

  • XY 可以为 0。widthheight 也可以为 0。如果将 widthheight 中有一个为 0 的 Rect 应用于 RectangleGeometry,将不会呈现结果 RectangleGeometry

  • 根据要求,XYwidthheight 的值可以不是整数。

Windows Phone OS

受以下版本支持: 8.0, 7.1, 7.0

Windows Phone

此类型的所有公共 static(在 Visual Basic 中为 Shared) 成员都是线程安全的。但不保证所有实例成员都是线程安全的。

显示: