鸿蒙OS开发文档 鸿蒙OS Lifecycle.Event

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

Lifecycle.Event

java.lang.Object
|---java.lang.Enum<Lifecycle.Event&
|---|---ohos.aafwk.ability.Lifecycle.Event
& public static enum Lifecycle.Event
& extends Enum<Lifecycle.Event&

表示生命周期事件。 当生命周期状态发生变化时,系统会调度一个事件。

系统安排生命周期更改并将事件分派到生命周期。 Lifecycle 然后将 Event 分派到已注册的 ILifecycleObserver 以响应生命周期更改。

例如,如果注册的 LifecycleObserver 收到 ON_ACTIVE 事件,它将调用 LifecycleObserver#onActive() 将能力或能力切片更改为 ACTIVE 状态。

枚举常量摘要

枚举常量描述
ON_ACTIVE指示ability或ability切片进入 ACTIVE 状态的事件。
ON_BACKGROUND指示ability或ability切片进入背景状态的事件。
ON_FOREGROUND指示ability或ability切片的生命周期状态从背景更改为不活动的事件。
ON_INACTIVE指示ability或ability切片进入 INACTIVE 状态的事件。
ON_START指示生命周期开始的事件。
ON_STOP表示生命周期即将被销毁的事件。
UNDEFINED未定义的生命周期事件,表明生命周期可能尚未开始或已被销毁。

方法总结

修饰符和类型方法描述
static Lifecycle.EventvalueOf(Stringname)返回具有指定名称的此类型的枚举常量。
static Lifecycle.Event[]values()按照声明的顺序返回包含此枚举类型常量的数组。
从 java.lang.Enum 类继承的方法
clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf
从 java.lang.Object 类继承的方法
getClass, notify, notifyAll, wait, wait, wait

枚举常量详细信息

UNDEFINED

public static final Lifecycle.Event UNDEFINED

未定义的生命周期事件,表明生命周期可能尚未开始或已被销毁。

ON_START

public static final Lifecycle.Event ON_START

指示生命周期开始的事件。

ON_INACTIVE

public static final Lifecycle.Event ON_INACTIVE

指示ability或ability切片进入 INACTIVE 状态的事件。

ON_ACTIVE

public static final Lifecycle.Event ON_ACTIVE

指示ability或ability切片进入 ACTIVE 状态的事件。

ON_BACKGROUND

public static final Lifecycle.Event ON_BACKGROUND

指示ability或ability切片进入背景状态的事件。

ON_FOREGROUND

public static final Lifecycle.Event ON_FOREGROUND

指示ability或ability切片的生命周期状态从背景更改为不活动的事件。

ON_STOP

public static final Lifecycle.Event ON_STOP

表示生命周期即将被销毁的事件。

方法详情

values

public static Lifecycle.Event[] values()

按照声明的顺序返回包含此枚举类型常量的数组。 此方法可用于迭代常量,如下所示:

for (Lifecycle.Event c : Lifecycle.Event.values())    System.out.println(c);

返回:

包含此枚举类型的常量的数组,按声明的顺序排列

valueOf

public static Lifecycle.Event valueOf(String name)

返回具有指定名称的此类型的枚举常量。 该字符串必须与用于在此类型中声明枚举常量的标识符完全匹配。 (不允许使用无关的空白字符。)

参数:

参数名称参数描述
name要返回的枚举常量的名称。

返回:

具有指定名称的枚举常量

Throws:

Throw名称Throw描述
IllegalArgumentException如果此枚举类型没有具有指定名称的常量
NullPointerException如果参数为空