鸿蒙OS开发文档鸿蒙OS Line

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

Line

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

public class Line
extends Object

提供线路规格和 alpha 值。

Since:

构造函数摘要

构造函数	描述
Line(Point startPoint, Point endPoint)	用于创建具有指定起点和终点的 Line 实例的构造函数。

方法总结

修饰符和类型	方法	描述
boolean	equals(Object object)	指示其他对象是否“等于”这个对象。
double	getDistance()	获取这条线的起点和终点之间的距离。
Point	getEndPoint()	获取直线的终点。
float	getEndPointX()	获取直线终点的 x 坐标。
float	getEndPointY()	获取直线终点的 y 坐标。
Point	getStartPoint()	获取直线的起点。
float	getStartPointX()	获取直线起点的 x 坐标。
float	getStartPointY()	获取直线起点的 y 坐标。
int	hashCode()	返回对象的哈希码值。
boolean	isEmpty()	检查这条线的起点和终点之间的距离是否为零。
boolean	isVertical(Line line)	检查指定的行和该行是否垂直。
void	set(float startPointX, float startPointY, float endPointX, float endPointY)	设置这条线的起点和终点的坐标。
void	set(Line line)	设置此行的属性。
void	set(Point startPoint, Point endPoint)	设置这条线的起点和终点。
void	setEmpty()	将此线的起点和终点的坐标设置为 (0, 0)。
void	setEndPoint(Point point)	设置这条线的终点。
void	setEndPointX(float x)	设置这条线的终点的 x 坐标。
void	setEndPointY(float y)	设置这条线的终点的 y 坐标。
void	setStartPoint(Point point)	设置这条线的起点。
void	setStartPointX(float x)	设置这条线的起点的 x 坐标。
void	setStartPointY(float y)	设置这条线的起点的 y 坐标。
String	toString()	返回对象的字符串表示形式。
void	translate(float dx, float dy)	将这条线平移指定的距离。
void	translate(Point point)	平移这条线，其在 x 轴和 y 轴上的偏移量由 Point 实例指定。

从类 java.lang.Object 继承的方法
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

构造函数详细信息

Line

public Line(Point startPoint, Point endPoint)

用于创建具有指定起点和终点的 Line 实例的构造函数。

参数：

参数名称	参数描述
startPoint	指示 Line 实例的指定起点。
endPoint	指示 Line 实例的指定端点。

Since:

方法详情

isEmpty

public boolean isEmpty()

检查这条线的起点和终点之间的距离是否为零。

如果此行的长度为零，则返回 true；否则返回 false。

Since:

set

public void set(Line line)

设置此行的属性。

参数：

参数名称	参数描述
line	表示要设置的线路属性。

Since:

set

public void set(float startPointX, float startPointY, float endPointX, float endPointY)

设置这条线的起点和终点的坐标。

参数：

参数名称	参数描述
startPointX	指示要设置的线的起点的 x 坐标。
startPointY	指示要设置的线的起点的 y 坐标。
endPointX	指示要设置的线的终点的 x 坐标。
endPointY	指示要设置的线的终点的 y 坐标。

Since:

set

public void set(Point startPoint, Point endPoint)

设置这条线的起点和终点。

参数：

参数名称	参数描述
startPoint	表示要设置的起点。
endPoint	指示要设置的终点。

Since:

setStartPointX

public void setStartPointX(float x)

设置这条线的起点的 x 坐标。

参数：

参数名称	参数描述
x	指示要设置的 x 坐标。

Since:

setStartPointY

public void setStartPointY(float y)

设置这条线的起点的 y 坐标。

参数：

参数名称	参数描述
y	指示要设置的 y 坐标。

Since:

setEndPointX

public void setEndPointX(float x)

设置这条线的终点的 x 坐标。

参数：

参数名称	参数描述
x	指示要设置的 x 坐标。

Since:

setEndPointY

public void setEndPointY(float y)

设置这条线的终点的 y 坐标。

参数：

参数名称	参数描述
y	指示要设置的 y 坐标。

Since:

setEmpty

public void setEmpty()

将此线的起点和终点的坐标设置为 (0, 0)。

Since:

getDistance

public double getDistance()

获取这条线的起点和终点之间的距离。

返回距离。

Since:

getStartPoint

public Point getStartPoint()

获取直线的起点。

返回线的起点。

Since:

getEndPoint

public Point getEndPoint()

获取直线的终点。

返回行的终点。

Since:

getStartPointX

public float getStartPointX()

获取直线起点的 x 坐标。

返回直线起点的 x 坐标。

Since:

getStartPointY

public float getStartPointY()

获取直线起点的 y 坐标。

返回直线起点的 y 坐标。

Since:

getEndPointX

public float getEndPointX()

获取直线终点的 x 坐标。

返回线的终点的 x 坐标。

Since:

getEndPointY

public float getEndPointY()

获取直线终点的 y 坐标。

返回直线终点的 y 坐标。

Since:

setStartPoint

public void setStartPoint(Point point)

设置这条线的起点。

参数：

参数名称	参数描述
point	表示要设置的起点。

Since:

setEndPoint

public void setEndPoint(Point point)

设置这条线的终点。

参数：

参数名称	参数描述
point	指示要设置的终点。

Since:

translate

public void translate(float dx, float dy)

将这条线平移指定的距离。

参数：

参数名称	参数描述
dx	表示这条线在 x 轴上的偏移量。
dy	表示这条线在 y 轴上的偏移量。

Since:

translate

public void translate(Point point)

平移这条线，其在 x 轴和 y 轴上的偏移量由 Point 实例指定。

参数：

参数名称	参数描述
point	指示指定此线在 x 轴和 y 轴上的偏移量的 Point 实例。

Since:

hashCode

public int hashCode()

从类复制的描述：对象

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

hashCode 的一般合约是：

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

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

覆盖：

类 Object 中的 hashCode

此对象的哈希码值。

equals

public boolean equals(Object object)

从类复制的描述：对象

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

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 中的等于

参数：

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

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

toString

public String toString()

从类复制的描述：对象

返回对象的字符串表示形式。通常，toString 方法返回一个“以文本方式表示”该对象的字符串。结果应该是一个简洁但信息丰富的表示，易于人们阅读。建议所有子类重写此方法。

Object 类的 toString 方法返回一个字符串，该字符串由对象作为其实例的类的名称、at 符号字符“@”和对象哈希码的无符号十六进制表示形式组成。换句话说，此方法返回一个等于以下值的字符串：

getClass().getName() + '@' + Integer.toHexString(hashCode())

覆盖：

类 Object 中的 toString

对象的字符串表示形式。

isVertical

public boolean isVertical(Line line)

检查指定的行和该行是否垂直。

参数：

参数名称	参数描述
line	表示指定的行。

如果两条线是垂直的，则返回 true；否则返回 false。

Since:

上一节：鸿蒙OS LayoutAlignment

下一节：鸿蒙OS Matrix

"鸿蒙OS开发文档"的目录

鸿蒙OS开发文档 鸿蒙OS Line

Line

构造函数摘要

方法总结

构造函数详细信息

Line

方法详情

isEmpty

set

set

set

setStartPointX

setStartPointY

setEndPointX

setEndPointY

setEmpty

getDistance

getStartPoint

getEndPoint

getStartPointX

getStartPointY

getEndPointX

getEndPointY

setStartPoint

setEndPoint

translate

translate

hashCode

equals

toString

isVertical

鸿蒙OS开发文档鸿蒙OS Line