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