android.app
Class ActivityGroup

java.lang.Object
  android.content.Context
      android.content.ContextWrapper
          android.view.ContextThemeWrapper
              android.app.Activity
                  android.app.ActivityGroup

All Implemented Interfaces:

ComponentCallbacks, KeyEvent.Callback, LayoutInflater.Factory, View.OnCreateContextMenuListener, Window.Callback

Direct Known Subclasses:

TabActivity

public class ActivityGroup
extends Activity

A screen that contains and runs multiple embedded activities.

Field Summary

protected LocalActivityManager

mLocalActivityManager This field should be made private, so it is hidden from the SDK.

Fields inherited from class android.app.Activity

DEFAULT_KEYS_DIALER, DEFAULT_KEYS_DISABLE, DEFAULT_KEYS_SEARCH_GLOBAL, DEFAULT_KEYS_SEARCH_LOCAL, DEFAULT_KEYS_SHORTCUT, FOCUSED_STATE_SET, mActivityInfo, mCalled, mConfigChangeFlags, mCurrentConfig, mDecor, mEmbeddedID, mFinished, mMainThread, mParent, mResultCode, mResultData, mStartedActivity, RESULT_CANCELED, RESULT_FIRST_USER, RESULT_OK

Fields inherited from class android.content.Context

ACTIVITY_SERVICE, ALARM_SERVICE, AUDIO_SERVICE, BIND_AUTO_CREATE, BIND_DEBUG_UNBIND, BLUETOOTH_SERVICE, CLIPBOARD_SERVICE, CONNECTIVITY_SERVICE, CONTEXT_IGNORE_SECURITY, CONTEXT_INCLUDE_CODE, KEYGUARD_SERVICE, LAYOUT_INFLATER_SERVICE, LOCATION_SERVICE, MODE_APPEND, MODE_PRIVATE, MODE_WORLD_READABLE, MODE_WORLD_WRITEABLE, NOTIFICATION_SERVICE, POWER_SERVICE, SEARCH_SERVICE, SENSOR_SERVICE, STATUS_BAR_SERVICE, TELEPHONY_SERVICE, VIBRATOR_SERVICE, WALLPAPER_SERVICE, WIFI_SERVICE, WINDOW_SERVICE

Constructor Summary

ActivityGroup()

ActivityGroup(boolean singleActivityMode)

Method Summary

(package private) void	dispatchActivityResult(String who, int requestCode, int resultCode, Intent data)
Activity	getCurrentActivity()
LocalActivityManager	getLocalActivityManager()
protected void	onCreate(Bundle savedInstanceState) Called when the activity is starting.
protected void	onDestroy() Perform any final cleanup before an activity is destroyed.
protected void	onPause() Called as part of the activity lifecycle when an activity is going into the background, but has not (yet) been killed.
protected void	onResume() Called after Activity.onRestoreInstanceState(android.os.Bundle), Activity.onRestart(), or Activity.onPause(), for your activity to start interacting with the user.
protected void	onSaveInstanceState(Bundle outState) Called to retrieve per-instance state from an activity before being killed so that the state can be restored in Activity.onCreate(android.os.Bundle) or Activity.onRestoreInstanceState(android.os.Bundle) (the Bundle populated by this method will be passed to both).
protected void	onStop() Called when you are no longer visible to the user.

Methods inherited from class android.app.Activity

addContentView, attach, closeOptionsMenu, createPendingResult, dismissDialog, dispatchKeyEvent, dispatchTouchEvent, dispatchTrackballEvent, finalize, findViewById, finish, finishActivity, finishActivityFromChild, finishFromChild, getActivityToken, getApplication, getCallingActivity, getCallingPackage, getChangingConfigurations, getComponentName, getCurrentFocus, getInstanceCount, getIntent, getLastNonConfigurationInstance, getLayoutInflater, getLocalClassName, getMenuInflater, getParent, getPreferences, getRequestedOrientation, getSystemService, getTaskId, getTitle, getTitleColor, getVolumeControlStream, getWallpaperDesiredMinimumHeight, getWallpaperDesiredMinimumWidth, getWindow, getWindowManager, isChild, isFinishing, isResumed, isTaskRoot, managedCommitUpdates, managedQuery, managedQuery, moveTaskToBack, onActivityResult, onApplyThemeResource, onChildTitleChanged, onConfigurationChanged, onContentChanged, onContextItemSelected, onContextMenuClosed, onCreateContextMenu, onCreateDescription, onCreateDialog, onCreateOptionsMenu, onCreatePanelMenu, onCreatePanelView, onCreateThumbnail, onCreateView, onKeyDown, onKeyMultiple, onKeyUp, onLowMemory, onMenuItemSelected, onMenuOpened, onNewIntent, onOptionsItemSelected, onOptionsMenuClosed, onPanelClosed, onPostCreate, onPostResume, onPrepareDialog, onPrepareOptionsMenu, onPreparePanel, onRestart, onRestoreInstanceState, onRetainNonConfigurationInstance, onSearchRequested, onStart, onTitleChanged, onTouchEvent, onTrackballEvent, onWindowAttributesChanged, onWindowFocusChanged, openContextMenu, openOptionsMenu, performRestart, performRestoreInstanceState, performResume, performSaveInstanceState, performStart, performStop, registerForContextMenu, removeDialog, requestWindowFeature, runOnUiThread, setContentView, setContentView, setContentView, setDefaultKeyMode, setFeatureDrawable, setFeatureDrawableAlpha, setFeatureDrawableResource, setFeatureDrawableUri, setIntent, setParent, setPersistent, setProgress, setProgressBarIndeterminate, setProgressBarIndeterminateVisibility, setProgressBarVisibility, setRequestedOrientation, setResult, setResult, setSecondaryProgress, setTitle, setTitle, setTitleColor, setVolumeControlStream, showDialog, startActivity, startActivityForResult, startActivityFromChild, startActivityIfNeeded, startManagingCursor, startNextMatchingActivity, startSearch, stopManagingCursor, takeKeyEvents, unregisterForContextMenu

Methods inherited from class android.view.ContextThemeWrapper

attachBaseContext, getTheme, setTheme

Methods inherited from class android.content.ContextWrapper

bindService, checkCallingOrSelfPermission, checkCallingOrSelfUriPermission, checkCallingPermission, checkCallingUriPermission, checkPermission, checkUriPermission, checkUriPermission, clearWallpaper, createPackageContext, databaseList, deleteDatabase, deleteFile, enforceCallingOrSelfPermission, enforceCallingOrSelfUriPermission, enforceCallingPermission, enforceCallingUriPermission, enforcePermission, enforceUriPermission, enforceUriPermission, fileList, getApplicationContext, getAssets, getBaseContext, getCacheDir, getClassLoader, getContentResolver, getDatabasePath, getDir, getFilesDir, getFileStreamPath, getMainLooper, getPackageCodePath, getPackageManager, getPackageName, getPackageResourcePath, getResources, getSharedPreferences, getWallpaper, grantUriPermission, openFileInput, openFileOutput, openOrCreateDatabase, peekWallpaper, registerReceiver, registerReceiver, removeStickyBroadcast, revokeUriPermission, sendBroadcast, sendBroadcast, sendOrderedBroadcast, sendOrderedBroadcast, sendStickyBroadcast, setWallpaper, setWallpaper, startInstrumentation, startService, stopService, unbindService, unregisterReceiver

Methods inherited from class android.content.Context

getString, getString, getText, obtainStyledAttributes, obtainStyledAttributes, obtainStyledAttributes, obtainStyledAttributes

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

mLocalActivityManager

protected LocalActivityManager mLocalActivityManager

This field should be made private, so it is hidden from the SDK.

Constructor Detail

ActivityGroup

public ActivityGroup()

ActivityGroup

public ActivityGroup(boolean singleActivityMode)

Method Detail

onCreate

protected void onCreate(Bundle savedInstanceState)

Description copied from class: Activity

Called when the activity is starting. This is where most initialization should go: calling Activity.setContentView(int) to inflate the activity's UI, using Activity.findViewById(int) to programmatically interact with widgets in the UI, calling Activity.managedQuery(android.net.Uri , String[], String, String[], String) to retrieve cursors for data being displayed, etc.

You can call Activity.finish() from within this function, in which case onDestroy() will be immediately called without any of the rest of the activity lifecycle (Activity.onStart(), Activity.onResume(), Activity.onPause(), etc) executing.

Derived classes must call through to the super class's implementation of this method. If they do not, an exception will be thrown.

Overrides:

onCreate in class Activity

Parameters:

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

See Also:

Activity.onStart(), Activity.onSaveInstanceState(android.os.Bundle), Activity.onRestoreInstanceState(android.os.Bundle), Activity.onPostCreate(android.os.Bundle)

onResume

protected void onResume()

Description copied from class: Activity

Called after Activity.onRestoreInstanceState(android.os.Bundle), Activity.onRestart(), or Activity.onPause(), for your activity to start interacting with the user. This is a good place to begin animations, open exclusive-access devices (such as the camera), etc.

Keep in mind that onResume is not the best indicator that your activity is visible to the user; a system window such as the keyguard may be in front. Use Activity.onWindowFocusChanged(boolean) to know for certain that your activity is visible to the user (for example, to resume a game).

Derived classes must call through to the super class's implementation of this method. If they do not, an exception will be thrown.

Overrides:

onResume in class Activity

See Also:

Activity.onRestoreInstanceState(android.os.Bundle), Activity.onRestart(), Activity.onPostResume(), Activity.onPause()

onSaveInstanceState

protected void onSaveInstanceState(Bundle outState)

Description copied from class: Activity

Called to retrieve per-instance state from an activity before being killed so that the state can be restored in Activity.onCreate(android.os.Bundle) or Activity.onRestoreInstanceState(android.os.Bundle) (the Bundle populated by this method will be passed to both).

This method is called before an activity may be killed so that when it comes back some time in the future it can restore its state. For example, if activity B is launched in front of activity A, and at some point activity A is killed to reclaim resources, activity A will have a chance to save the current state of its user interface via this method so that when the user returns to activity A, the state of the user interface can be restored via Activity.onCreate(android.os.Bundle) or Activity.onRestoreInstanceState(android.os.Bundle).

Do not confuse this method with activity lifecycle callbacks such as Activity.onPause(), which is always called when an activity is being placed in the background or on its way to destruction, or Activity.onStop() which is called before destruction. One example of when Activity.onPause() and Activity.onStop() is called and not this method is when a user navigates back from activity B to activity A: there is no need to call Activity.onSaveInstanceState(android.os.Bundle) on B because that particular instance will never be restored, so the system avoids calling it. An example when Activity.onPause() is called and not Activity.onSaveInstanceState(android.os.Bundle) is when activity B is launched in front of activity A: the system may avoid calling Activity.onSaveInstanceState(android.os.Bundle) on activity A if it isn't killed during the lifetime of B since the state of the user interface of A will stay intact.

The default implementation takes care of most of the UI per-instance state for you by calling View.onSaveInstanceState() on each view in the hierarchy that has an id, and by saving the id of the currently focused view (all of which is restored by the default implementation of Activity.onRestoreInstanceState(android.os.Bundle)). If you override this method to save additional information not captured by each individual view, you will likely want to call through to the default implementation, otherwise be prepared to save all of the state of each view yourself.

If called, this method will occur before Activity.onStop(). There are no guarantees about whether it will occur before or after Activity.onPause().

Overrides:

onSaveInstanceState in class Activity

Parameters:

outState - Bundle in which to place your saved state.

See Also:

Activity.onCreate(android.os.Bundle), Activity.onRestoreInstanceState(android.os.Bundle), Activity.onPause()

onPause

protected void onPause()

Description copied from class: Activity

Called as part of the activity lifecycle when an activity is going into the background, but has not (yet) been killed. The counterpart to Activity.onResume().

When activity B is launched in front of activity A, this callback will be invoked on A. B will not be created until A's Activity.onPause() returns, so be sure to not do anything lengthy here.

This callback is mostly used for saving any persistent state the activity is editing, to present a "edit in place" model to the user and making sure nothing is lost if there are not enough resources to start the new activity without first killing this one. This is also a good place to do things like stop animations and other things that consume a noticeable mount of CPU in order to make the switch to the next activity as fast as possible, or to close resources that are exclusive access such as the camera.

In situations where the system needs more memory it may kill paused processes to reclaim resources. Because of this, you should be sure that all of your state is saved by the time you return from this function. In general Activity.onSaveInstanceState(android.os.Bundle) is used to save per-instance state in the activity and this method is used to store global persistent data (in content providers, files, etc.)

After receiving this call you will usually receive a following call to Activity.onStop() (after the next activity has been resumed and displayed), however in some cases there will be a direct call back to Activity.onResume() without going through the stopped state.

Derived classes must call through to the super class's implementation of this method. If they do not, an exception will be thrown.

Overrides:

onPause in class Activity

See Also:

Activity.onResume(), Activity.onSaveInstanceState(android.os.Bundle), Activity.onStop()

onStop

protected void onStop()

Description copied from class: Activity

Called when you are no longer visible to the user. You will next receive either Activity.onStart(), Activity.onDestroy(), or nothing, depending on later user activity.

Note that this method may never be called, in low memory situations where the system does not have enough memory to keep your activity's process running after its Activity.onPause() method is called.

Derived classes must call through to the super class's implementation of this method. If they do not, an exception will be thrown.

Overrides:

onStop in class Activity

See Also:

Activity.onRestart(), Activity.onResume(), Activity.onSaveInstanceState(android.os.Bundle), Activity.onDestroy()

onDestroy

protected void onDestroy()

Description copied from class: Activity

Perform any final cleanup before an activity is destroyed. This can happen either because the activity is finishing (someone called Activity.finish() on it, or because the system is temporarily destroying this instance of the activity to save space. You can distinguish between these two scenarios with the Activity.isFinishing() method.

Note: do not count on this method being called as a place for saving data! For example, if an activity is editing data in a content provider, those edits should be committed in either Activity.onPause() or Activity.onSaveInstanceState(android.os.Bundle), not here. This method is usually implemented to free resources like threads that are associated with an activity, so that a destroyed activity does not leave such things around while the rest of its application is still running. There are situations where the system will simply kill the activity's hosting process without calling this method (or any others) in it, so it should not be used to do things that are intended to remain around after the process goes away.

Derived classes must call through to the super class's implementation of this method. If they do not, an exception will be thrown.

Overrides:

onDestroy in class Activity

See Also:

Activity.onPause(), Activity.onStop(), Activity.finish(), Activity.isFinishing()

getCurrentActivity

public Activity getCurrentActivity()

getLocalActivityManager

public final LocalActivityManager getLocalActivityManager()

dispatchActivityResult

void dispatchActivityResult(String who,
                            int requestCode,
                            int resultCode,
                            Intent data)

Overrides:

dispatchActivityResult in class Activity