鸿蒙OS Color

Color

java.lang.Object

|---ohos.agp.utils.Color

public class Color
extends Object

提供颜色规范和 alpha 值。

Since:

1

字段摘要

修饰符和类型	字段	描述
static Color	BLACK	表示黑色，用 0xFF000000 表示。
static Color	BLUE	表示蓝色，用 0xFF0000FF 表示。
static Color	CYAN	表示青色，用 0xFF00FFFF 表示。
static Color	DKGRAY	表示深灰色，用0xFF444444表示。
static Color	GRAY	表示灰色，用0xFF808080表示。
static Color	GREEN	表示绿色，用 0xFF00FF00 表示。
static Color	LTGRAY	表示浅灰色，用0xFFCCCCCC表示。
static Color	MAGENTA	表示洋红色，用 0xFFFF00FF 表示。
static Color	RED	表示红色，用 0xFFFF0000 表示。
static Color	TRANSPARENT	表示透明度颜色，用0x00000000表示。
static Color	WHITE	表示白色，用 0xFFFFFFFF 表示。
static Color	YELLOW	表示黄色，用 0xFFFFFF00 表示。

构造函数摘要

构造函数	描述
Color()	用于创建 Color 实例的默认构造函数。
Color(int color)	用于创建指定颜色的 Color 实例的构造函数。

方法总结

修饰符和类型	方法	描述
static int	alpha(int color)	获取指定颜色的 alpha 值。
static int	applyAlpha(int color, float alpha)	将给定的 alpha 应用于颜色。
static int	argb(int alpha, int red, int green, int blue)	根据指定的 ARGB 值获取颜色值。
boolean	equals(Object object)	指示其他对象是否“等于”这个对象。
static int	getIntColor(String colorStr)	根据指定的字符串值获取颜色值。
int	getValue()	获取用于创建颜色对象的颜色值。
int	hashCode()	返回对象的哈希码值。
static int	rgb(int red, int green, int blue)	根据指定的 RGB 值获取颜色值。

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

字段详细信息

BLACK

public static final Color BLACK

表示黑色，用 0xFF000000 表示。

BLUE

public static final Color BLUE

表示蓝色，用 0xFF0000FF 表示。

CYAN

public static final Color CYAN

表示青色，用 0xFF00FFFF 表示。

DKGRAY

public static final Color DKGRAY

表示深灰色，用0xFF444444表示。

GRAY

public static final Color GRAY

表示灰色，用0xFF808080表示。

GREEN

public static final Color GREEN

表示绿色，用 0xFF00FF00 表示。

LTGRAY

public static final Color LTGRAY

表示浅灰色，用0xFFCCCCCC表示。

MAGENTA

public static final Color MAGENTA

表示洋红色，用 0xFFFF00FF 表示。

RED

public static final Color RED

表示红色，用 0xFFFF0000 表示。

TRANSPARENT

public static final Color TRANSPARENT

表示透明度颜色，用0x00000000表示。

WHITE

public static final Color WHITE

表示白色，用 0xFFFFFFFF 表示。

YELLOW

public static final Color YELLOW

表示黄色，用 0xFFFFFF00 表示。

构造函数详细信息

Color

public Color()

用于创建 Color 实例的默认构造函数。

默认构造函数定义透明度颜色。

Color

public Color(int color)

用于创建指定颜色的 Color 实例的构造函数。

参数：

参数名称	参数描述
color	表示要设置的颜色，可以自定义，也可以通过Color的常量指定。

方法详情

getValue

public int getValue()

获取用于创建颜色对象的颜色值。

返回:

返回颜色值。

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

返回:

此对象的哈希码值。

alpha

public static int alpha(int color)

获取指定颜色的 alpha 值。

参数：

参数名称	参数描述
color	表示颜色值。

返回:

返回颜色的 alpha 值。

Since:

4

argb

public static int argb(int alpha, int red, int green, int blue)

根据指定的 ARGB 值获取颜色值。

参数：

参数名称	参数描述
alpha	表示 alpha 值。
red	表示颜色的红色值。
green	表示颜色的绿色值。
blue	表示颜色的蓝色值。

返回:

返回颜色值。

Since:

4

rgb

public static int rgb(int red, int green, int blue)

根据指定的 RGB 值获取颜色值。

参数：

参数名称	参数描述
red	表示颜色的红色值。
green	表示颜色的绿色值。
blue	表示颜色的蓝色值。

返回:

返回颜色值。

Since:

4

getIntColor

public static int getIntColor(String colorStr)

根据指定的字符串值获取颜色值。

参数：

参数名称	参数描述
colorStr	表示颜色的字符串值。

返回:

返回颜色值。

Throws:

Throw名称	Throw描述
IllegalArgumentException	如果输入参数无效，则抛出此异常。

Since:

4

applyAlpha

public static int applyAlpha(int color, float alpha)

将给定的 alpha 应用于颜色。

参数：

参数名称	参数描述
color	表示基色。
alpha	指示要应用的 alpha。

返回:

返回颜色值。

Since:

7