Point 结构

2013/12/13

表示二维空间内的 X 和 Y 坐标对。还可以表示某些属性用法的“逻辑点”。

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

public struct Point : IFormattable
<object property="X,Y"/>
-or
<object property="X Y"/>

XAML 值

X

Point 的 X 坐标分量。

Y

Point 的 Y 坐标分量。

  • 空格或逗号可以作为分隔符。请参见下面“备注”中的“XAML 中的点值”标题。

  • 一些 XAML 用法使用 Point 类型来表示逻辑点而非逻辑像素坐标空间中的点。在这种情况下,要求 XY 的值是介于 0 到 1(包括 0 和 1)之间的浮点值。请参见下面“备注”中的“逻辑点”标题。

Point 类型公开以下成员。

  名称说明
公共方法Point初始化包含指定值的 Point 结构。
返回顶部

  名称说明
公共属性X获取或设置此 Point 结构的 X 坐标值。
公共属性Y获取或设置此 PointY 坐标值。
返回顶部

  名称说明
公共方法Equals(Object)确定指定的对象是否为 Point 以及它是否包含与此 Point 相同的值。 (重写 ValueType.Equals(Object)。)
公共方法Equals(Point)比较两个 Point 结构是否相等。
受保护的方法Finalize允许 Object 在垃圾回收器回收该对象之前尝试释放资源并执行其他清理操作。 (从 Object 继承。)
公共方法GetHashCode返回此 Point 的哈希代码。 (重写 ValueType.GetHashCode()。)
公共方法GetType获取当前实例的 Type (从 Object 继承。)
受保护的方法MemberwiseClone创建当前 Object 的浅表副本。 (从 Object 继承。)
公共方法ToString()创建此 PointString 表示形式。 (重写 ValueType.ToString()。)
公共方法ToString(IFormatProvider)创建此 PointString 表示形式。
返回顶部

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

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

Point 结构通常用于指定位置。根据上下文,该位置可能在总体 Windows Phone 内容区域框架中,或在特定元素的参考框架中。

Point 是从对事件处理程序中使用的 GetPosition 方法的调用中返回的类型。Point 还可以用于 PointAnimation 的某些属性,如 ToFromPoint 还可以用作执行命中测试的限定符。

根据要求,PointXY 值可以不是整数。有关大量要求和使用非整数值的某些 Point 用法的信息,请参见下面的“逻辑点”部分。

根据应用 Point 的特定属性,XY 可能是负数。这通常会导致指定 Windows Phone 内容区域之外的坐标的一个 Point 定义,除非再进行平移。许多属性(例如 EllipseGeometry.RadiusX)将拒绝具有负 XYPoint

说明注意:

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

XAML 中的点值

对于采用 Point 的 XAML 特性,可以指定一个 X,Y 值对作为字符串。XY 之间的分隔符可以是逗号(可能加上零个或多个空格),也可以是一个或多个空格。点的常见约定是使用逗号分隔符。类型转换器将格式化字符串转换为 Point 结构。

将逗号用作 X,Y 字符串中的分隔符可能与区域性设置冲突,在区域性设置中如果将十进制值作为字符串输入,逗号是十进制分隔符。对于 Point 表示绝对坐标空间中的点(即不是逻辑点)的情况,通常应为 XY 使用整数值。即使不是正在开发的区域性中的约定或应用程序的目标区域性中的约定,当在 XAML 中指定 Point 特性时,也将句点 (.) 用于 Point 的非整数 XY 值。

无法将 Point 结构声明为 ResourceDictionary 中的资源。

逻辑点

Windows Phone 中某些 Point 结构的用法不直接与坐标参考框架相关。这些是逻辑点,其中 XY 都应是 0 和 1 之间(包含 0 和 1)的值。这是 X,Y 值可以是浮点值而不是限定为整数值的主要情况。在指定具有 X 和 Y 维度的某些值时使用逻辑点值,然后将 Point 值映射为某个表示形式或行为,该表示形式或行为的实际坐标可能由不同属性指定。使用逻辑点的示例包括 KeySpline 值(可用于设置动画速度),以及在使用默认 RelativeToBoundingBox 模式时的一些 LinearGradientBrushRadialGradientBrush 的值。是逻辑点映射的 Point 结构属性可能使小于 0 或大于 1 的值无效,但是这取决于特定属性。

Windows Phone OS

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

Windows Phone

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

显示:
© 2014 Microsoft