Line
java.lang.Object
|—ohos.agp.utils.Line
public class Line
extends Object
提供线路规格和 alpha 值。
Since:
5
构造函数摘要
构造函数 | 描述 |
---|---|
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:
5
方法详情
isEmpty
public boolean isEmpty()
检查这条线的起点和终点之间的距离是否为零。
返回:
如果此行的长度为零,则返回 true; 否则返回 false。
Since:
5
set
public void set(Line line)
设置此行的属性。
参数:
参数名称 | 参数描述 |
---|---|
line | 表示要设置的线路属性。 |
Since:
5
set
public void set(float startPointX, float startPointY, float endPointX, float endPointY)
设置这条线的起点和终点的坐标。
参数:
参数名称 | 参数描述 |
---|---|
startPointX | 指示要设置的线的起点的 x 坐标。 |
startPointY | 指示要设置的线的起点的 y 坐标。 |
endPointX | 指示要设置的线的终点的 x 坐标。 |
endPointY | 指示要设置的线的终点的 y 坐标。 |
Since:
5
set
public void set(Point startPoint, Point endPoint)
设置这条线的起点和终点。
参数:
参数名称 | 参数描述 |
---|---|
startPoint | 表示要设置的起点。 |
endPoint | 指示要设置的终点。 |
Since:
5
setStartPointX
public void setStartPointX(float x)
设置这条线的起点的 x 坐标。
参数:
参数名称 | 参数描述 |
---|---|
x | 指示要设置的 x 坐标。 |
Since:
5
setStartPointY
public void setStartPointY(float y)
设置这条线的起点的 y 坐标。
参数:
参数名称 | 参数描述 |
---|---|
y | 指示要设置的 y 坐标。 |
Since:
5
setEndPointX
public void setEndPointX(float x)
设置这条线的终点的 x 坐标。
参数:
参数名称 | 参数描述 |
---|---|
x | 指示要设置的 x 坐标。 |
Since:
5
setEndPointY
public void setEndPointY(float y)
设置这条线的终点的 y 坐标。
参数:
参数名称 | 参数描述 |
---|---|
y | 指示要设置的 y 坐标。 |
Since:
5
setEmpty
public void setEmpty()
将此线的起点和终点的坐标设置为 (0, 0)。
Since:
5
getDistance
public double getDistance()
获取这条线的起点和终点之间的距离。
返回:
返回距离。
Since:
5
getStartPoint
public Point getStartPoint()
获取直线的起点。
返回:
返回线的起点。
Since:
5
getEndPoint
public Point getEndPoint()
获取直线的终点。
返回:
返回行的终点。
Since:
5
getStartPointX
public float getStartPointX()
获取直线起点的 x 坐标。
返回:
返回直线起点的 x 坐标。
Since:
5
getStartPointY
public float getStartPointY()
获取直线起点的 y 坐标。
返回:
返回直线起点的 y 坐标。
Since:
5
getEndPointX
public float getEndPointX()
获取直线终点的 x 坐标。
返回:
返回线的终点的 x 坐标。
Since:
5
getEndPointY
public float getEndPointY()
获取直线终点的 y 坐标。
返回:
返回直线终点的 y 坐标。
Since:
5
setStartPoint
public void setStartPoint(Point point)
设置这条线的起点。
参数:
参数名称 | 参数描述 |
---|---|
point | 表示要设置的起点。 |
Since:
5
setEndPoint
public void setEndPoint(Point point)
设置这条线的终点。
参数:
参数名称 | 参数描述 |
---|---|
point | 指示要设置的终点。 |
Since:
5
translate
public void translate(float dx, float dy)
将这条线平移指定的距离。
参数:
参数名称 | 参数描述 |
---|---|
dx | 表示这条线在 x 轴上的偏移量。 |
dy | 表示这条线在 y 轴上的偏移量。 |
Since:
5
translate
public void translate(Point point)
平移这条线,其在 x 轴和 y 轴上的偏移量由 Point 实例指定。
参数:
参数名称 | 参数描述 |
---|---|
point | 指示指定此线在 x 轴和 y 轴上的偏移量的 Point 实例。 |
Since:
5
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:
5