鸿蒙OS开发文档 鸿蒙OS Circle

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

Circle

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

public class Circle
extends Object

提供圆规格和 alpha 值。

Since:

5

构造函数摘要

构造函数描述
Circle(float x, float y, float radius)用于创建具有指定中心坐标和半径的 Circle 实例的构造函数。

方法总结

修饰符和类型方法描述
booleanequals(Object object)指示其他对象是否“等于”这个对象。
doublegetArea()获取该圆的面积。
PointgetCenter()获得这个圆的中心。
floatgetCenterX()获取圆心的 x 坐标。
floatgetCenterY()获取圆心的 y 坐标。
floatgetRadius()获取此圆的半径。
inthashCode()返回对象的哈希码值。
booleanisEmpty()检查此圆的半径是否小于零。
booleanisInclude(float x, float y)检查指定点 (x, y) 是否包含在此圆中。
booleanisInclude(float x1, float y1, float r1)检查该圆中是否包含具有指定中心坐标和半径的圆。
booleanisInclude(Circle circle)检查指定的圈子是否包含在此圈子中。
booleanisInclude(Point point)检查指定的 Point 实例是否包含在此圆中。
booleanisIntersect(float x1, float y1, float r1)检查具有指定中心坐标和半径的圆是否与该圆相交。
booleanisIntersect(Circle circle)检查指定的圆是否与该圆相交。
voidset(float x, float y, float radius)根据指定的中心坐标和半径设置此圆的属性。
voidset(Circle circle)根据指定的圆设置该圆的属性。
voidset(Point point, float radius)根据指定的 Point 实例和半径设置此圆的属性。
voidsetCenter(float x, float y)根据指定的坐标设置此圆的中心。
voidsetCenter(Point point)设置此圆的中心。
voidsetCenterX(float x)设置圆心的 x 坐标。
voidsetCenterY(float y)设置圆心的 y 坐标。
voidsetEmpty()将圆的中心坐标设置为 (0, 0) 并将半径设置为零。
voidsetRadius(float radius)设置此圆的半径。
voidshrink(float size)缩小此圆的半径。
voidstretch(float size)拉伸这个圆的半径。
StringtoString()返回对象的字符串表示形式。
voidtranslate(float dx, float dy)将此圆平移指定距离。
voidtranslate(Point point)平移这个圆,它在 x 轴和 y 轴上的偏移量由一个点指定。
voidzoom(float factor)放大或缩小这个圆圈。
从类 java.lang.Object 继承的方法
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

构造函数详细信息

Circle

public Circle(float x, float y, float radius)

用于创建具有指定中心坐标和半径的 Circle 实例的构造函数。

参数:

参数名称参数描述
x表示圆心的指定 x 坐标。
y指示圆心的指定 y 坐标。
radius表示圆的指定半径。

Since:

5

方法详情

isEmpty

public boolean isEmpty()

检查此圆的半径是否小于零。

返回:

如果圆的半径小于零,则返回 true; 否则返回 false。

Since:

5

set

public void set(float x, float y, float radius)

根据指定的中心坐标和半径设置此圆的属性。

参数:

参数名称参数描述
x表示圆心的指定 x 坐标。
y指示圆心的指定 y 坐标。
radius表示指定的半径。

Since:

5

setEmpty

public void setEmpty()

将圆的中心坐标设置为 (0, 0) 并将半径设置为零。

Since:

5

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。

hashCode

public int hashCode()

从类复制的描述:对象

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

hashCode 的一般合约是:

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

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

覆盖:

类 Object 中的 hashCode

返回:

此对象的哈希码值。

toString

public String toString()

从类复制的描述:对象

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

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

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

覆盖:

类 Object 中的 toString

返回:

对象的字符串表示形式。

set

public void set(Point point, float radius)

根据指定的 Point 实例和半径设置此圆的属性。

参数:

参数名称参数描述
point指示要设置的圆的中心。
radius指示要设置的圆的半径。

Since:

5

set

public void set(Circle circle)

根据指定的圆设置该圆的属性。

参数:

参数名称参数描述
circle表示指定的圆。

Since:

5

getRadius

public float getRadius()

获取此圆的半径。

返回:

返回此圆的半径。

Since:

5

setRadius

public void setRadius(float radius)

设置此圆的半径。

参数:

参数名称参数描述
radius表示要设置的半径。

Since:

5

getCenter

public Point getCenter()

获得这个圆的中心。

返回:

返回此圆的中心。

Since:

5

getCenterX

public float getCenterX()

获取圆心的 x 坐标。

返回:

返回圆心的 x 坐标。

Since:

5

getCenterY

public float getCenterY()

获取圆心的 y 坐标。

返回:

返回圆心的 y 坐标。

Since:

5

setCenter

public void setCenter(float x, float y)

根据指定的坐标设置此圆的中心。

参数:

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

Since:

5

setCenter

public void setCenter(Point point)

设置此圆的中心。

参数:

参数名称参数描述
point表示要设置的中心。

Since:

5

setCenterX

public void setCenterX(float x)

设置圆心的 x 坐标。

参数:

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

Since:

5

setCenterY

public void setCenterY(float y)

设置圆心的 y 坐标。

参数:

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

Since:

5

isInclude

public boolean isInclude(float x, float y)

检查指定点 (x, y) 是否包含在此圆中。

参数:

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

返回:

如果指定的点包含在圆中,则返回 true; 否则返回 false。

Since:

5

isInclude

public boolean isInclude(Point point)

检查指定的 Point 实例是否包含在此圆中。

参数:

参数名称参数描述
point表示指定的 Point 实例。

返回:

如果指定的 Point 实例包含在此圆中,则返回 true; 否则返回 false。

Since:

5

isInclude

public boolean isInclude(float x1, float y1, float r1)

检查该圆中是否包含具有指定中心坐标和半径的圆。

参数:

参数名称参数描述
x1表示指定圆心的 x 坐标。
y1指示指定圆心的 y 坐标。
r1表示指定圆的半径。

返回:

如果指定的圆圈包含在此圆圈中,则返回 true; 否则返回 false。

Since:

5

isInclude

public boolean isInclude(Circle circle)

检查指定的圈子是否包含在此圈子中。

参数:

参数名称参数描述
circle表示指定的圆。

返回:

如果指定的圆圈包含在此圆圈中,则返回 true; 否则返回 false。

Since:

5

isIntersect

public boolean isIntersect(float x1, float y1, float r1)

检查具有指定中心坐标和半径的圆是否与该圆相交。

参数:

参数名称参数描述
x1表示指定圆心的 x 坐标。
y1指示指定圆心的 y 坐标。
r1表示指定圆的半径。

返回:

如果指定的圆与该圆相交,则返回 true; 否则返回 false。

Since:

5

isIntersect

public boolean isIntersect(Circle circle)

检查指定的圆是否与该圆相交。

参数:

参数名称参数描述
circle表示指定的圆。

返回:

如果指定的圆与该圆相交,则返回 true; 否则返回 false。

Since:

5

zoom

public void zoom(float factor)

放大或缩小这个圆圈。

参数:

参数名称参数描述
factor表示缩放系数。

Since:

5

stretch

public void stretch(float size)

拉伸这个圆的半径。

参数:

参数名称参数描述
size表示延伸半径的长度。

Since:

5

shrink

public void shrink(float size)

缩小此圆的半径。

参数:

参数名称参数描述
size指示要从原始半径切开的长度。

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指示指定圆在 x 轴和 y 轴上的偏移量的点。

Since:

5

getArea

public double getArea()

获取该圆的面积。

返回:

返回此圆的面积。

Since:

5