Most visited

Recently visited

Added in API level 1
Deprecated since API level 13

ActivityGroup

public class ActivityGroup
extends Activity

java.lang.Object
   ↳ android.content.Context
     ↳ android.content.ContextWrapper
       ↳ android.view.ContextThemeWrapper
         ↳ android.app.Activity
           ↳ android.app.ActivityGroup
Known Direct Subclasses


此类在API级别13中已被弃用。
改为使用新的FragmentFragmentManager API; 这些也可以通过Android兼容性套件在较早的平台上使用。

包含并运行多个嵌入式活动的屏幕。

Summary

Inherited constants

From class android.app.Activity
From class android.content.Context
From interface android.content.ComponentCallbacks2

Inherited fields

From class android.app.Activity

Public constructors

ActivityGroup()
ActivityGroup(boolean singleActivityMode)

Public methods

Activity getCurrentActivity()
final LocalActivityManager getLocalActivityManager()

Protected methods

void onCreate(Bundle savedInstanceState)

当活动开始时调用。

void onDestroy()

在活动销毁之前执行任何最终清理。

void onPause()

作为活动生命周期的一部分,当活动进入后台但尚未(尚未)死亡时调用。

void onResume()

后调用 onRestoreInstanceState(Bundle)onRestart() ,或 onPause() ,为您的活动启动与用户交互。

void onSaveInstanceState(Bundle outState)

在被杀之前调用以从活动中检索每个实例的状态,以便可以在 onCreate(Bundle)onRestoreInstanceState(Bundle)恢复状态(由此方法填充的 Bundle将传递给两者)。

void onStop()

当用户不再可见时调用。

Inherited methods

From class android.app.Activity
From class android.view.ContextThemeWrapper
From class android.content.ContextWrapper
From class android.content.Context
From class java.lang.Object
From interface android.view.LayoutInflater.Factory2
From interface android.view.Window.Callback
From interface android.view.KeyEvent.Callback
From interface android.view.View.OnCreateContextMenuListener
From interface android.content.ComponentCallbacks2
From interface android.view.LayoutInflater.Factory
From interface android.content.ComponentCallbacks

Public constructors

ActivityGroup

Added in API level 1
ActivityGroup ()

ActivityGroup

Added in API level 1
ActivityGroup (boolean singleActivityMode)

Parameters
singleActivityMode boolean

Public methods

getCurrentActivity

Added in API level 1
Activity getCurrentActivity ()

Returns
Activity

getLocalActivityManager

Added in API level 1
LocalActivityManager getLocalActivityManager ()

Returns
LocalActivityManager

Protected methods

onCreate

Added in API level 1
void onCreate (Bundle savedInstanceState)

当活动开始时调用。 这是大多数初始化应该去的地方:调用setContentView(int)setContentView(int)活动的UI,使用findViewById(int)以编程方式与UI中的小部件进行交互,调用managedQuery(android.net.Uri, String[], String, String[], String)以检索正在显示的数据的光标等。

您可以拨打 finish()从这个函数中,在这种情况下的onDestroy()将被立即调用没有任何活动的生命周期(其余的 onStart()onResume()onPause()执行等)。

派生类必须调用超类的这个方法的实现。 如果他们不这样做,就会抛出异常。

Parameters
savedInstanceState Bundle: If the activity is being re-initialized after previously being shut down then this Bundle contains the data it most recently supplied in onSaveInstanceState(Bundle). Note: Otherwise it is null.

onDestroy

Added in API level 1
void onDestroy ()

在活动销毁之前执行任何最终清理。 这可能是由于活动正在完成(有人称为finish() ,或者系统暂时销毁此活动的实例以节省空间),您可以使用isFinishing()方法区分这两种情况。

注意:不要将此方法称为保存数据的地方! 例如,如果一项活动正在编辑内容提供商中的数据,那么这些编辑应该在onPause()onSaveInstanceState(Bundle) ,而不是在这里onSaveInstanceState(Bundle) 这种方法通常被实现为释放资源,例如与活动相关联的线程,这样一个被销毁的活动就不会离开这些东西,而其他应用程序仍在运行。 在某些情况下,系统只会在不调用该方法(或任何其他方法)的情况下终止该活动的托管过程,因此不应该将其用于在过程消失后执行那些旨在保留的事情。

派生类必须调用超类的这个方法的实现。 如果他们不这样做,就会抛出异常。

onPause

Added in API level 1
void onPause ()

作为活动生命周期的一部分,当活动进入后台但尚未(尚未)死亡时调用。 onResume()对应的是onResume()

当活动B在活动A前面启动时,此回调将在A上被调用。在A的 onPause()返回之前,B不会被创建,因此请务必在此处不做任何冗长的操作。

此回调主要用于保存活动正在编辑的任何持续状态,向用户呈现“就地编辑”模型,并确保没有足够的资源来启动新活动,而不必先杀死该活动。 这也是一个很好的地方,可以停止动画和其他消耗大量CPU的内容,以便尽快切换到下一个活动,或者关闭像摄像机这样的独占访问资源。

在系统需要更多内存的情况下,它可能会终止暂停的进程以回收资源。 因此,您应该确保在您从此函数返回时保存所有状态。 通常, onSaveInstanceState(Bundle)用于在活动中保存每个实例的状态,并且此方法用于存储全局持久数据(在内容提供者,文件等中)

收到此通话后,您通常会收到以下电话 onStop() (在下一个活动恢复并显示后),但在某些情况下,将直接回拨至 onResume()而不通过停止状态。

派生类必须调用超类的这个方法的实现。 如果他们不这样做,就会抛出异常。

onResume

Added in API level 1
void onResume ()

后调用onRestoreInstanceState(Bundle)onRestart() ,或onPause() ,为您的活动启动与用户交互。 这是开始动画,打开专用访问设备(如相机)等的好地方。

请记住,onResume并不是您的活动对用户可见的最佳指标; 系统窗口(如键盘)可能在前面。 使用onWindowFocusChanged(boolean)可以确定您的活动对用户是可见的(例如,恢复游戏)。

派生类必须调用超类的这个方法的实现。 如果他们不这样做,就会抛出异常。

onSaveInstanceState

Added in API level 1
void onSaveInstanceState (Bundle outState)

在被杀之前调用以从活动检索每个实例的状态,以便可以在 onCreate(Bundle)onRestoreInstanceState(Bundle)恢复状态(由此方法填充的 Bundle将传递到两者)。

在一个活动可能被杀死之前调用这个方法,以便在将来它有一段时间它可以恢复它的状态。 例如,如果活动B在活动A之前启动,并且在某些时刻活动A被杀死以回收资源,则活动A将有机会通过此方法保存其用户界面的当前状态,以便当用户返回时到活动A,可以通过onCreate(Bundle)onRestoreInstanceState(Bundle)恢复用户界面的状态。

不要将此方法与活动生命周期回调混淆,例如onPause() (当活动置于后台或销毁途中时始终调用此方法),或在销毁前调用onStop() 调用onPause()onStop()时的一个示例,而不是此方法是当用户从活动B返回到活动A时:不需要在B上调用onSaveInstanceState(Bundle) ,因为该特定实例永远不会恢复,因此系统可避免调用它。 onPause()而不是onSaveInstanceState(Bundle)时的一个示例是活动B在活动A前面启动时:如果活动A在A的用户界面的状态期间未在B的生存onSaveInstanceState(Bundle) ,则系统可以避免对活动A调用onSaveInstanceState(Bundle)将保持完好。

默认实现通过在层次结构中每个具有id的视图上调用onSaveInstanceState() ,并通过保存当前焦点视图的ID(所有视图都由缺省实现恢复)来为您处理大部分UI每实例状态onRestoreInstanceState(Bundle) )。 如果您重写此方法以保存未被每个视图捕获的附加信息,那么您可能需要调用默认实现,否则应准备好保存每个视图的所有状态。

如果调用,则此方法将在onStop()之前onStop() 对于onPause()之前或之后是否会发生这种情况,我们无法保证。

Parameters
outState Bundle: Bundle in which to place your saved state.

onStop

Added in API level 1
void onStop ()

当用户不再可见时调用。 接下来,您将收到无论是onRestart()onDestroy() ,或没有,这取决于后来的用户活动。

派生类必须调用超类的这个方法的实现。 如果他们不这样做,就会抛出异常。

Hooray!