鸿蒙OS开发文档 鸿蒙OS Point

2024-02-25 开发教程 鸿蒙OS开发文档 匿名 2

Point

java.lang.Object
|---ohos.agp.utils.Point

public class Point
extends Object

创建用于记录像素的实例的实用程序类。

每个实例代表一个二维坐标,可以用来表示一个像素。

Since:

1

字段摘要

修饰符和类型字段描述
float[]position表示一个点所代表的位置。

构造函数摘要

构造函数描述
Point()用于创建 Point 实例的无参数构造函数。
Point(float x, float y)根据 (x,y) 坐标在指定位置构造一个点。
Point(Point point)在指定位置构造一个点。

方法总结

修饰符和类型方法描述
booleanequals(float x, float y)检查此点是否等于具有给定坐标的指定点。
booleanequals(Object o)指示其他对象是否“等于”这个对象。
floatgetPointX()获取此 Point 的 x 坐标的浮点表示。
intgetPointXToInt()获取此 Point 的 x 坐标的整数表示。
floatgetPointY()获取此 Point 的 y 坐标的浮点表示。
intgetPointYToInt()获取此 Point 的 y 坐标的整数表示。
inthashCode()返回对象的哈希码值。
booleanisInRect(Rect rect)检查此点是否在指定的矩形中。
voidmodify(float x, float y)根据指定点的坐标修改此点。
voidmodify(Point point)根据指定点修改此点。
StringtoString()获取点的字符串值。
voidtranslate(float dx, float dy)翻译这一点。
从类 java.lang.Object 继承的方法
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

字段详细信息

position

public final float[] position

表示一个点所代表的位置。

一维浮点数组用于表示该点的 X 和 Y 坐标。

构造函数详细信息

Point

public Point()

用于创建 Point 实例的无参数构造函数。

该方法用于在坐标空间的原点 (0,0) 处构造一个点。

Point

public Point(Point point)

在指定位置构造一个点。

参数:

参数名称参数描述
point表示初始化点

Since:

4

Point

public Point(float x, float y)

根据 (x,y) 坐标在指定位置构造一个点。

参数:

参数名称参数描述
x表示X坐标,类型为float。
y表示Y坐标,类型为float。

方法详情

getPointX

public float getPointX()

获取此 Point 的 x 坐标的浮点表示。

返回:

返回 x 坐标。

Since:

3

getPointY

public float getPointY()

获取此 Point 的 y 坐标的浮点表示。

返回:

返回 y 坐标。

Since:

4

getPointXToInt

public int getPointXToInt()

获取此 Point 的 x 坐标的整数表示。

返回:

返回 x 坐标。

Since:

4

getPointYToInt

public int getPointYToInt()

获取此 Point 的 y 坐标的整数表示。

返回:

返回 y 坐标。

Since:

4

equals

public final boolean equals(float x, float y)

检查此点是否等于具有给定坐标的指定点。

参数:

参数名称参数描述
x表示指定点的X坐标。
y表示指定点的Y坐标。

返回:

如果两点相等则返回 true; 否则返回 false。

Since:

4

equals

public boolean equals(Object o)

指示其他对象是否“等于”这个对象。

equals 方法在非空对象引用上实现等价关系:

  • 它是自反的:对于任何非空引用值 x,x.equals(x) 应该返回 true。
  • 它是对称的:对于任何非空引用值 x 和 y,当且仅当 y.equals(x) 返回 true 时,x.equals(y) 才应该返回 true。
  • 它是可传递的:对于任何非空引用值 x、y 和 z,如果 x.equals(y) 返回 true 并且 y.equals(z) 返回 true,则 x.equals(z) 应该返回 true。
  • 它是一致的:对于任何非空引用值 x 和 y,x.equals(y) 的多次调用始终返回 true 或始终返回 false,前提是没有修改对象上 equals 比较中使用的信息。
  • 对于任何非空引用值 x,x.equals(null) 应该返回 false。

Object 类的 equals 方法实现了对象上最有区别的可能等价关系; 也就是说,对于任何非空引用值 x 和 y,当且仅当 x 和 y 引用同一个对象(x == y 的值为 true)时,此方法才返回 true。

请注意,每当重写该方法时,通常都需要重写 hashCode 方法,以维护 hashCode 方法的一般约定,即相等的对象必须具有相等的哈希码。

覆盖:

类 Object 中的等于

参数:

参数名称参数描述
o要与之比较的参考对象。

返回:

如果此对象与 obj 参数相同,则为 true; 否则为 false。

hashCode

public int hashCode()

返回对象的哈希码值。 支持这种方法是为了有利于哈希表,例如 HashMap 提供的那些。

hashCode 的一般合约是:

  • 每当在 Java 应用程序执行期间对同一对象多次调用时,hashCode 方法必须始终返回相同的整数,前提是没有修改对象上相等比较中使用的信息。 该整数不需要从应用程序的一次执行到同一应用程序的另一次执行保持一致。
  • 如果两个对象根据 equals(Object) 方法相等,则对两个对象中的每一个调用 hashCode 方法必须产生相同的整数结果。
  • 如果根据 Object.equals(java.lang.Object) 方法,如果两个对象不相等,则不要求对两个对象中的每一个调用 hashCode 方法必须产生不同的整数结果。 但是,程序员应该意识到,为不相等的对象生成不同的整数结果可能会提高哈希表的性能。

在合理可行的情况下,由 Object 类定义的 hashCode 方法确实为不同的对象返回不同的整数。 (这通常通过将对象的内部地址转换为整数来实现,但 Java™ 编程语言不需要这种实现技术。)

覆盖:

类 Object 中的 hashCode

返回:

此对象的哈希码值。

modify

public final void modify(float x, float y)

根据指定点的坐标修改此点。

参数:

参数名称参数描述
x表示指定点的X坐标。
y表示指定点的Y坐标。

Since:

4

modify

public final void modify(Point point)

根据指定点修改此点。

参数:

参数名称参数描述
point表示指定点。

Since:

4

translate

public final void translate(float dx, float dy)

翻译这一点。

参数:

参数名称参数描述
dx指示要平移的 x 轴距离。
dy指示要平移的 y 轴距离。

Since:

4

isInRect

public boolean isInRect(Rect rect)

检查此点是否在指定的矩形中。

参数:

参数名称参数描述
rect表示指定的矩形。

返回:

如果此 Point 在指定的矩形中,则为 true; 否则返回 false。

Since:

3

toString

public String toString()

获取点的字符串值。

覆盖:

类 Object 中的 toString

返回:

返回点的字符串值。

Since:

4