Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)
Android APIs
public class

ActivityInfo

extends ComponentInfo
implements Parcelable
java.lang.Object
   ↳ android.content.pm.PackageItemInfo
     ↳ android.content.pm.ComponentInfo
       ↳ android.content.pm.ActivityInfo

Class Overview

Information you can retrieve about a particular application activity or receiver. This corresponds to information collected from the AndroidManifest.xml's <activity> and <receiver> tags.

Summary

Constants
int CONFIG_DENSITY Bit in configChanges that indicates that the activity can itself handle density changes.
int CONFIG_FONT_SCALE Bit in configChanges that indicates that the activity can itself handle changes to the font scaling factor.
int CONFIG_KEYBOARD Bit in configChanges that indicates that the activity can itself handle changes to the keyboard type.
int CONFIG_KEYBOARD_HIDDEN Bit in configChanges that indicates that the activity can itself handle changes to the keyboard or navigation being hidden/exposed.
int CONFIG_LAYOUT_DIRECTION Bit in configChanges that indicates that the activity can itself handle the change to layout direction.
int CONFIG_LOCALE Bit in configChanges that indicates that the activity can itself handle changes to the locale.
int CONFIG_MCC Bit in configChanges that indicates that the activity can itself handle changes to the IMSI MCC.
int CONFIG_MNC Bit in configChanges that indicates that the activity can itself handle changes to the IMSI MNC.
int CONFIG_NAVIGATION Bit in configChanges that indicates that the activity can itself handle changes to the navigation type.
int CONFIG_ORIENTATION Bit in configChanges that indicates that the activity can itself handle changes to the screen orientation.
int CONFIG_SCREEN_LAYOUT Bit in configChanges that indicates that the activity can itself handle changes to the screen layout.
int CONFIG_SCREEN_SIZE Bit in configChanges that indicates that the activity can itself handle the screen size.
int CONFIG_SMALLEST_SCREEN_SIZE Bit in configChanges that indicates that the activity can itself handle the smallest screen size.
int CONFIG_TOUCHSCREEN Bit in configChanges that indicates that the activity can itself handle changes to the touchscreen type.
int CONFIG_UI_MODE Bit in configChanges that indicates that the activity can itself handle the ui mode.
int FLAG_ALLOW_TASK_REPARENTING Bit in flags that indicates that the activity can be moved between tasks based on its task affinity.
int FLAG_ALWAYS_RETAIN_TASK_STATE Bit in flags indicating that, when the activity is the root of a task, that task's stack should never be cleared when it is relaunched from home.
int FLAG_CLEAR_TASK_ON_LAUNCH Bit in flags indicating that, when the activity is the root of a task, that task's stack should be cleared each time the user re-launches it from home.
int FLAG_EXCLUDE_FROM_RECENTS Bit in flags that indicates that the activity should not appear in the list of recently launched activities.
int FLAG_FINISH_ON_CLOSE_SYSTEM_DIALOGS Bit in flags indicating that, when a request to close system windows happens, this activity is finished.
int FLAG_FINISH_ON_TASK_LAUNCH Bit in flags indicating that, when the activity's task is relaunched from home, this activity should be finished.
int FLAG_HARDWARE_ACCELERATED Value for flags : true when the application's rendering should be hardware accelerated.
int FLAG_IMMERSIVE Bit in flags corresponding to an immersive activity that wishes not to be interrupted by notifications.
int FLAG_MULTIPROCESS Bit in flags indicating whether this activity is able to run in multiple processes.
int FLAG_NO_HISTORY Bit in flags indicating that, when the user navigates away from an activity, it should be finished.
int FLAG_SINGLE_USER Bit in flags : If set, a single instance of the receiver will run for all users on the device.
int FLAG_STATE_NOT_NEEDED Bit in flags indicating that the activity's state is not required to be saved, so that if there is a failure the activity will not be removed from the activity stack.
int LAUNCH_MULTIPLE Constant corresponding to standard in the launchMode attribute.
int LAUNCH_SINGLE_INSTANCE Constant corresponding to singleInstance in the launchMode attribute.
int LAUNCH_SINGLE_TASK Constant corresponding to singleTask in the launchMode attribute.
int LAUNCH_SINGLE_TOP Constant corresponding to singleTop in the launchMode attribute.
int SCREEN_ORIENTATION_BEHIND Constant corresponding to behind in the screenOrientation attribute.
int SCREEN_ORIENTATION_FULL_SENSOR Constant corresponding to fullSensor in the screenOrientation attribute.
int SCREEN_ORIENTATION_FULL_USER Constant corresponding to fullUser in the screenOrientation attribute.
int SCREEN_ORIENTATION_LANDSCAPE Constant corresponding to landscape in the screenOrientation attribute.
int SCREEN_ORIENTATION_LOCKED Constant corresponding to locked in the screenOrientation attribute.
int SCREEN_ORIENTATION_NOSENSOR Constant corresponding to nosensor in the screenOrientation attribute.
int SCREEN_ORIENTATION_PORTRAIT Constant corresponding to portrait in the screenOrientation attribute.
int SCREEN_ORIENTATION_REVERSE_LANDSCAPE Constant corresponding to reverseLandscape in the screenOrientation attribute.
int SCREEN_ORIENTATION_REVERSE_PORTRAIT Constant corresponding to reversePortrait in the screenOrientation attribute.
int SCREEN_ORIENTATION_SENSOR Constant corresponding to sensor in the screenOrientation attribute.
int SCREEN_ORIENTATION_SENSOR_LANDSCAPE Constant corresponding to sensorLandscape in the screenOrientation attribute.
int SCREEN_ORIENTATION_SENSOR_PORTRAIT Constant corresponding to sensorPortrait in the screenOrientation attribute.
int SCREEN_ORIENTATION_UNSPECIFIED Constant corresponding to unspecified in the screenOrientation attribute.
int SCREEN_ORIENTATION_USER Constant corresponding to user in the screenOrientation attribute.
int SCREEN_ORIENTATION_USER_LANDSCAPE Constant corresponding to userLandscape in the screenOrientation attribute.
int SCREEN_ORIENTATION_USER_PORTRAIT Constant corresponding to userPortrait in the screenOrientation attribute.
int UIOPTION_SPLIT_ACTION_BAR_WHEN_NARROW Flag for use with uiOptions .
[Expand]
Inherited Constants
From interface android.os.Parcelable
Fields
public static final Creator < ActivityInfo > CREATOR
public int configChanges Bit mask of kinds of configuration changes that this activity can handle itself (without being restarted by the system).
public int flags Options that have been set in the activity declaration in the manifest.
public int launchMode The launch mode style requested by the activity.
public String parentActivityName If defined, the activity named here is the logical parent of this activity.
public String permission Optional name of a permission required to be able to access this Activity.
public int screenOrientation The preferred screen orientation this activity would like to run in.
public int softInputMode The desired soft input mode for this activity's main window.
public String targetActivity If this is an activity alias, this is the real activity class to run for it.
public String taskAffinity The affinity this activity has for another task in the system.
public int theme A style resource identifier (in the package's resources) of this activity's theme.
public int uiOptions The desired extra UI options for this activity and its main window.
[Expand]
Inherited Fields
From class android.content.pm.ComponentInfo
From class android.content.pm.PackageItemInfo
Public Constructors
ActivityInfo ()
ActivityInfo ( ActivityInfo orig)
Public Methods
int describeContents ()
Describe the kinds of special objects contained in this Parcelable's marshalled representation.
void dump ( Printer pw, String prefix)
final int getThemeResource ()
Return the theme resource identifier to use for this activity.
String toString ()
Returns a string containing a concise, human-readable description of this object.
void writeToParcel ( Parcel dest, int parcelableFlags)
[Expand]
Inherited Methods
From class android.content.pm.ComponentInfo
From class android.content.pm.PackageItemInfo
From class java.lang.Object
From interface android.os.Parcelable

Constants

public static final int CONFIG_DENSITY

Bit in configChanges that indicates that the activity can itself handle density changes. Set from the configChanges attribute.

Constant Value: 4096 (0x00001000)

public static final int CONFIG_FONT_SCALE

Added in API level 1

Bit in configChanges that indicates that the activity can itself handle changes to the font scaling factor. Set from the configChanges attribute. This is not a core resource configuration, but a higher-level value, so its constant starts at the high bits.

Constant Value: 1073741824 (0x40000000)

public static final int CONFIG_KEYBOARD

Added in API level 1

Bit in configChanges that indicates that the activity can itself handle changes to the keyboard type. Set from the configChanges attribute.

Constant Value: 16 (0x00000010)

public static final int CONFIG_KEYBOARD_HIDDEN

Added in API level 1

Bit in configChanges that indicates that the activity can itself handle changes to the keyboard or navigation being hidden/exposed. Note that inspite of the name, this applies to the changes to any hidden states: keyboard or navigation. Set from the configChanges attribute.

Constant Value: 32 (0x00000020)

public static final int CONFIG_LAYOUT_DIRECTION

Bit in configChanges that indicates that the activity can itself handle the change to layout direction. Set from the configChanges attribute.

Constant Value: 8192 (0x00002000)

public static final int CONFIG_LOCALE

Added in API level 1

Bit in configChanges that indicates that the activity can itself handle changes to the locale. Set from the configChanges attribute.

Constant Value: 4 (0x00000004)

public static final int CONFIG_MCC

Added in API level 1

Bit in configChanges that indicates that the activity can itself handle changes to the IMSI MCC. Set from the configChanges attribute.

Constant Value: 1 (0x00000001)

public static final int CONFIG_MNC

Added in API level 1

Bit in configChanges that indicates that the activity can itself handle changes to the IMSI MNC. Set from the configChanges attribute.

Constant Value: 2 (0x00000002)

public static final int CONFIG_NAVIGATION

Added in API level 1

Bit in configChanges that indicates that the activity can itself handle changes to the navigation type. Set from the configChanges attribute.

Constant Value: 64 (0x00000040)

public static final int CONFIG_ORIENTATION

Added in API level 1

Bit in configChanges that indicates that the activity can itself handle changes to the screen orientation. Set from the configChanges attribute.

Constant Value: 128 (0x00000080)

public static final int CONFIG_SCREEN_LAYOUT

Added in API level 4

Bit in configChanges that indicates that the activity can itself handle changes to the screen layout. Set from the configChanges attribute.

Constant Value: 256 (0x00000100)

public static final int CONFIG_SCREEN_SIZE

Bit in configChanges that indicates that the activity can itself handle the screen size. Set from the configChanges attribute. This will be set by default for applications that target an earlier version than HONEYCOMB_MR2 ... however , you will not see the bit set here becomes some applications incorrectly compare configChanges against an absolute value rather than correctly masking out the bits they are interested in. Please don't do that, thanks.

Constant Value: 1024 (0x00000400)

public static final int CONFIG_SMALLEST_SCREEN_SIZE

Bit in configChanges that indicates that the activity can itself handle the smallest screen size. Set from the configChanges attribute. This will be set by default for applications that target an earlier version than HONEYCOMB_MR2 ... however , you will not see the bit set here becomes some applications incorrectly compare configChanges against an absolute value rather than correctly masking out the bits they are interested in. Please don't do that, thanks.

Constant Value: 2048 (0x00000800)

public static final int CONFIG_TOUCHSCREEN

Added in API level 1

Bit in configChanges that indicates that the activity can itself handle changes to the touchscreen type. Set from the configChanges attribute.

Constant Value: 8 (0x00000008)

public static final int CONFIG_UI_MODE

Added in API level 8

Bit in configChanges that indicates that the activity can itself handle the ui mode. Set from the configChanges attribute.

Constant Value: 512 (0x00000200)

public static final int FLAG_ALLOW_TASK_REPARENTING

Added in API level 1

Bit in flags that indicates that the activity can be moved between tasks based on its task affinity. Set from the allowTaskReparenting attribute.

Constant Value: 64 (0x00000040)

public static final int FLAG_ALWAYS_RETAIN_TASK_STATE

Added in API level 1

Bit in flags indicating that, when the activity is the root of a task, that task's stack should never be cleared when it is relaunched from home. Set from the alwaysRetainTaskState attribute.

Constant Value: 8 (0x00000008)

public static final int FLAG_CLEAR_TASK_ON_LAUNCH

Added in API level 1

Bit in flags indicating that, when the activity is the root of a task, that task's stack should be cleared each time the user re-launches it from home. As a result, the user will always return to the original activity at the top of the task. This flag only applies to activities that are used to start the root of a new task. Set from the clearTaskOnLaunch attribute.

Constant Value: 4 (0x00000004)

public static final int FLAG_EXCLUDE_FROM_RECENTS

Added in API level 1

Bit in flags that indicates that the activity should not appear in the list of recently launched activities. Set from the excludeFromRecents attribute.

Constant Value: 32 (0x00000020)

public static final int FLAG_FINISH_ON_CLOSE_SYSTEM_DIALOGS

Added in API level 5

Bit in flags indicating that, when a request to close system windows happens, this activity is finished. Set from the finishOnCloseSystemDialogs attribute.

Constant Value: 256 (0x00000100)

public static final int FLAG_FINISH_ON_TASK_LAUNCH

Added in API level 1

Bit in flags indicating that, when the activity's task is relaunched from home, this activity should be finished. Set from the finishOnTaskLaunch attribute.

Constant Value: 2 (0x00000002)

public static final int FLAG_HARDWARE_ACCELERATED

Value for flags : true when the application's rendering should be hardware accelerated.

Constant Value: 512 (0x00000200)

public static final int FLAG_IMMERSIVE

Bit in flags corresponding to an immersive activity that wishes not to be interrupted by notifications. Applications that hide the system notification bar with FLAG_FULLSCREEN may still be interrupted by high-priority notifications; for example, an incoming phone call may use fullScreenIntent to present a full-screen in-call activity to the user, pausing the current activity as a side-effect. An activity with FLAG_IMMERSIVE set, however, will not be interrupted; the notification may be shown in some other way (such as a small floating "toast" window). Note that this flag will always reflect the Activity's android:immersive manifest definition, even if the Activity's immersive state is changed at runtime via setImmersive(boolean) .

Constant Value: 2048 (0x00000800)

public static final int FLAG_MULTIPROCESS

Added in API level 1

Bit in flags indicating whether this activity is able to run in multiple processes. If true, the system may instantiate it in the some process as the process starting it in order to conserve resources. If false, the default, it always runs in processName . Set from the multiprocess attribute.

Constant Value: 1 (0x00000001)

public static final int FLAG_NO_HISTORY

Added in API level 3

Bit in flags indicating that, when the user navigates away from an activity, it should be finished. Set from the noHistory attribute.

Constant Value: 128 (0x00000080)

public static final int FLAG_SINGLE_USER

Bit in flags : If set, a single instance of the receiver will run for all users on the device. Set from the singleUser attribute. Note that this flag is only relevant for ActivityInfo structures that are describing receiver components; it is not applied to activities.

Constant Value: 1073741824 (0x40000000)

public static final int FLAG_STATE_NOT_NEEDED

Added in API level 1

Bit in flags indicating that the activity's state is not required to be saved, so that if there is a failure the activity will not be removed from the activity stack. Set from the stateNotNeeded attribute.

Constant Value: 16 (0x00000010)

public static final int LAUNCH_MULTIPLE

Added in API level 1

Constant corresponding to standard in the launchMode attribute.

Constant Value: 0 (0x00000000)

public static final int LAUNCH_SINGLE_INSTANCE

Added in API level 1

Constant corresponding to singleInstance in the launchMode attribute.

Constant Value: 3 (0x00000003)

public static final int LAUNCH_SINGLE_TASK

Added in API level 1

Constant corresponding to singleTask in the launchMode attribute.

Constant Value: 2 (0x00000002)

public static final int LAUNCH_SINGLE_TOP

Added in API level 1

Constant corresponding to singleTop in the launchMode attribute.

Constant Value: 1 (0x00000001)

public static final int SCREEN_ORIENTATION_BEHIND

Added in API level 1

Constant corresponding to behind in the screenOrientation attribute.

Constant Value: 3 (0x00000003)

public static final int SCREEN_ORIENTATION_FULL_SENSOR

Added in API level 9

Constant corresponding to fullSensor in the screenOrientation attribute.

Constant Value: 10 (0x0000000a)

public static final int SCREEN_ORIENTATION_FULL_USER

Constant corresponding to fullUser in the screenOrientation attribute.

Constant Value: 13 (0x0000000d)

public static final int SCREEN_ORIENTATION_LANDSCAPE

Added in API level 1

Constant corresponding to landscape in the screenOrientation attribute.

Constant Value: 0 (0x00000000)

public static final int SCREEN_ORIENTATION_LOCKED

Constant corresponding to locked in the screenOrientation attribute.

Constant Value: 14 (0x0000000e)

public static final int SCREEN_ORIENTATION_NOSENSOR

Added in API level 1

Constant corresponding to nosensor in the screenOrientation attribute.

Constant Value: 5 (0x00000005)

public static final int SCREEN_ORIENTATION_PORTRAIT

Added in API level 1

Constant corresponding to portrait in the screenOrientation attribute.

Constant Value: 1 (0x00000001)

public static final int SCREEN_ORIENTATION_REVERSE_LANDSCAPE

Added in API level 9

Constant corresponding to reverseLandscape in the screenOrientation attribute.

Constant Value: 8 (0x00000008)

public static final int SCREEN_ORIENTATION_REVERSE_PORTRAIT

Added in API level 9

Constant corresponding to reversePortrait in the screenOrientation attribute.

Constant Value: 9 (0x00000009)

public static final int SCREEN_ORIENTATION_SENSOR

Added in API level 1

Constant corresponding to sensor in the screenOrientation attribute.

Constant Value: 4 (0x00000004)

public static final int SCREEN_ORIENTATION_SENSOR_LANDSCAPE

Added in API level 9

Constant corresponding to sensorLandscape in the screenOrientation attribute.

Constant Value: 6 (0x00000006)

public static final int SCREEN_ORIENTATION_SENSOR_PORTRAIT

Added in API level 9

Constant corresponding to sensorPortrait in the screenOrientation attribute.

Constant Value: 7 (0x00000007)

public static final int SCREEN_ORIENTATION_UNSPECIFIED

Added in API level 1

Constant corresponding to unspecified in the screenOrientation attribute.

Constant Value: -1 (0xffffffff)

public static final int SCREEN_ORIENTATION_USER

Added in API level 1

Constant corresponding to user in the screenOrientation attribute.

Constant Value: 2 (0x00000002)

public static final int SCREEN_ORIENTATION_USER_LANDSCAPE

Constant corresponding to userLandscape in the screenOrientation attribute.

Constant Value: 11 (0x0000000b)

public static final int SCREEN_ORIENTATION_USER_PORTRAIT

Constant corresponding to userPortrait in the screenOrientation attribute.

Constant Value: 12 (0x0000000c)

public static final int UIOPTION_SPLIT_ACTION_BAR_WHEN_NARROW

Flag for use with uiOptions . Indicates that the action bar should put all action items in a separate bar when the screen is narrow.

This value corresponds to "splitActionBarWhenNarrow" for the uiOptions XML attribute.

Constant Value: 1 (0x00000001)

Fields

public static final Creator < ActivityInfo > CREATOR

Added in API level 1

public int configChanges

Added in API level 1

Bit mask of kinds of configuration changes that this activity can handle itself (without being restarted by the system). Contains any combination of CONFIG_FONT_SCALE , CONFIG_MCC , CONFIG_MNC , CONFIG_LOCALE , CONFIG_TOUCHSCREEN , CONFIG_KEYBOARD , CONFIG_NAVIGATION , CONFIG_ORIENTATION , CONFIG_SCREEN_LAYOUT and CONFIG_LAYOUT_DIRECTION . Set from the configChanges attribute.

public int launchMode

Added in API level 1

The launch mode style requested by the activity. From the launchMode attribute, one of LAUNCH_MULTIPLE , LAUNCH_SINGLE_TOP , LAUNCH_SINGLE_TASK , or LAUNCH_SINGLE_INSTANCE .

public String parentActivityName

If defined, the activity named here is the logical parent of this activity.

public String permission

Added in API level 1

Optional name of a permission required to be able to access this Activity. From the "permission" attribute.

public int softInputMode

Added in API level 3

The desired soft input mode for this activity's main window. Set from the windowSoftInputMode attribute in the activity's manifest. May be any of the same values allowed for WindowManager.LayoutParams.softInputMode . If 0 (unspecified), the mode from the theme will be used.

public String targetActivity

Added in API level 1

If this is an activity alias, this is the real activity class to run for it. Otherwise, this is null.

public String taskAffinity

Added in API level 1

The affinity this activity has for another task in the system. The string here is the name of the task, often the package name of the overall package. If null, the activity has no affinity. Set from the taskAffinity attribute.

public int theme

Added in API level 1

A style resource identifier (in the package's resources) of this activity's theme. From the "theme" attribute or, if not set, 0.

public int uiOptions

The desired extra UI options for this activity and its main window. Set from the uiOptions attribute in the activity's manifest.

Public Constructors

public ActivityInfo ()

Added in API level 1

public ActivityInfo ( ActivityInfo orig)

Added in API level 1

Public Methods

public int describeContents ()

Added in API level 1

Describe the kinds of special objects contained in this Parcelable's marshalled representation.

Returns
  • a bitmask indicating the set of special object types marshalled by the Parcelable.

public void dump ( Printer pw, String prefix)

Added in API level 1

public final int getThemeResource ()

Added in API level 1

Return the theme resource identifier to use for this activity. If the activity defines a theme, that is used; else, the application theme is used.

Returns
  • The theme associated with this activity.

public String toString ()

Added in API level 1

Returns a string containing a concise, human-readable description of this object. Subclasses are encouraged to override this method and provide an implementation that takes into account the object's type and data. The default implementation is equivalent to the following expression:

          getClass().getName() + '@' + Integer.toHexString(hashCode())
         

See Writing a useful toString method if you intend implementing your own toString method.

Returns
  • a printable representation of this object.

public void writeToParcel ( Parcel dest, int parcelableFlags)

Added in API level 1