鴻蒙OS Point

Point

java.lang.Object

|---ohos.agp.utils.Point

public class Point
extends Object

創(chuàng)建用于記錄像素的實例的實用程序類。

每個實例代表一個二維坐標，可以用來表示一個像素。

Since:

1

字段摘要

修飾符和類型	字段	描述
float[]	position	表示一個點所代表的位置。

構造函數(shù)摘要

構造函數(shù)	描述
Point()	用于創(chuàng)建 Point 實例的無參數(shù)構造函數(shù)。
Point(float x, float y)	根據(jù) (x,y) 坐標在指定位置構造一個點。
Point(Point point)	在指定位置構造一個點。

方法總結(jié)

修飾符和類型	方法	描述
boolean	equals(float x, float y)	檢查此點是否等于具有給定坐標的指定點。
boolean	equals(Object o)	指示其他對象是否“等于”這個對象。
float	getPointX()	獲取此 Point 的 x 坐標的浮點表示。
int	getPointXToInt()	獲取此 Point 的 x 坐標的整數(shù)表示。
float	getPointY()	獲取此 Point 的 y 坐標的浮點表示。
int	getPointYToInt()	獲取此 Point 的 y 坐標的整數(shù)表示。
int	hashCode()	返回對象的哈希碼值。
boolean	isInRect(Rect rect)	檢查此點是否在指定的矩形中。
void	modify(float x, float y)	根據(jù)指定點的坐標修改此點。
void	modify(Point point)	根據(jù)指定點修改此點。
String	toString()	獲取點的字符串值。
void	translate(float dx, float dy)	翻譯這一點。

從類 java.lang.Object 繼承的方法
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

字段詳細信息

position

public final float[] position

表示一個點所代表的位置。

一維浮點數(shù)組用于表示該點的 X 和 Y 坐標。

構造函數(shù)詳細信息

Point

public Point()

用于創(chuàng)建 Point 實例的無參數(shù)構造函數(shù)。

該方法用于在坐標空間的原點 (0,0) 處構造一個點。

Point

public Point(Point point)

在指定位置構造一個點。

參數(shù)：

參數(shù)名稱	參數(shù)描述
point	表示初始化點

Since:

4

Point

public Point(float x, float y)

根據(jù) (x,y) 坐標在指定位置構造一個點。

參數(shù)：

參數(shù)名稱	參數(shù)描述
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 坐標的整數(shù)表示。

返回:

返回 x 坐標。

Since:

4

getPointYToInt

public int getPointYToInt()

獲取此 Point 的 y 坐標的整數(shù)表示。

返回:

返回 y 坐標。

Since:

4

equals

public final boolean equals(float x, float y)

檢查此點是否等于具有給定坐標的指定點。

參數(shù)：

參數(shù)名稱	參數(shù)描述
x	表示指定點的X坐標。
y	表示指定點的Y坐標。

返回:

如果兩點相等則返回 true； 否則返回 false。

Since:

4

equals

public boolean equals(Object o)

指示其他對象是否“等于”這個對象。

equals 方法在非空對象引用上實現(xiàn)等價關系：

• 它是自反的：對于任何非空引用值 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) 的多次調(diào)用始終返回 true 或始終返回 false，前提是沒有修改對象上 equals 比較中使用的信息。
• 對于任何非空引用值 x，x.equals(null) 應該返回 false。

Object 類的 equals 方法實現(xiàn)了對象上最有區(qū)別的可能等價關系； 也就是說，對于任何非空引用值 x 和 y，當且僅當 x 和 y 引用同一個對象（x == y 的值為 true）時，此方法才返回 true。

請注意，每當重寫該方法時，通常都需要重寫 hashCode 方法，以維護 hashCode 方法的一般約定，即相等的對象必須具有相等的哈希碼。

覆蓋：

類 Object 中的等于

參數(shù)：

參數(shù)名稱	參數(shù)描述
o	要與之比較的參考對象。

返回:

如果此對象與 obj 參數(shù)相同，則為 true； 否則為 false。

hashCode

public int hashCode()

返回對象的哈希碼值。 支持這種方法是為了有利于哈希表，例如 HashMap 提供的那些。

hashCode 的一般合約是：

• 每當在 Java 應用程序執(zhí)行期間對同一對象多次調(diào)用時，hashCode 方法必須始終返回相同的整數(shù)，前提是沒有修改對象上相等比較中使用的信息。 該整數(shù)不需要從應用程序的一次執(zhí)行到同一應用程序的另一次執(zhí)行保持一致。
• 如果兩個對象根據(jù) equals(Object) 方法相等，則對兩個對象中的每一個調(diào)用 hashCode 方法必須產(chǎn)生相同的整數(shù)結(jié)果。
• 如果根據(jù) Object.equals(java.lang.Object) 方法，如果兩個對象不相等，則不要求對兩個對象中的每一個調(diào)用 hashCode 方法必須產(chǎn)生不同的整數(shù)結(jié)果。 但是，程序員應該意識到，為不相等的對象生成不同的整數(shù)結(jié)果可能會提高哈希表的性能。

在合理可行的情況下，由 Object 類定義的 hashCode 方法確實為不同的對象返回不同的整數(shù)。 （這通常通過將對象的內(nèi)部地址轉(zhuǎn)換為整數(shù)來實現(xiàn)，但 Java? 編程語言不需要這種實現(xiàn)技術。）

覆蓋：

類 Object 中的 hashCode

返回:

此對象的哈希碼值。

modify

public final void modify(float x, float y)

根據(jù)指定點的坐標修改此點。

參數(shù)：

參數(shù)名稱	參數(shù)描述
x	表示指定點的X坐標。
y	表示指定點的Y坐標。

Since:

4

modify

public final void modify(Point point)

根據(jù)指定點修改此點。

參數(shù)：

參數(shù)名稱	參數(shù)描述
point	表示指定點。

Since:

4

translate

public final void translate(float dx, float dy)

翻譯這一點。

參數(shù)：

參數(shù)名稱	參數(shù)描述
dx	指示要平移的 x 軸距離。
dy	指示要平移的 y 軸距離。

Since:

4

isInRect

public boolean isInRect(Rect rect)

檢查此點是否在指定的矩形中。

參數(shù)：

參數(shù)名稱	參數(shù)描述
rect	表示指定的矩形。

返回:

如果此 Point 在指定的矩形中，則為 true； 否則返回 false。

Since:

3

toString

public String toString()

獲取點的字符串值。

覆蓋：

類 Object 中的 toString

返回:

返回點的字符串值。

Since:

4