FileDocCategorySizeDatePackage
ActivityInfo.javaAPI DocAndroid 1.5 API14000Wed May 06 22:41:54 BST 2009android.content.pm

ActivityInfo

public class ActivityInfo extends ComponentInfo implements android.os.Parcelable
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.

Fields Summary
public int
theme
A style resource identifier (in the package's resources) of this activity's theme. From the "theme" attribute or, if not set, 0.
public static final int
LAUNCH_MULTIPLE
Constant corresponding to standard in the {@link android.R.attr#launchMode} attribute.
public static final int
LAUNCH_SINGLE_TOP
Constant corresponding to singleTop in the {@link android.R.attr#launchMode} attribute.
public static final int
LAUNCH_SINGLE_TASK
Constant corresponding to singleTask in the {@link android.R.attr#launchMode} attribute.
public static final int
LAUNCH_SINGLE_INSTANCE
Constant corresponding to singleInstance in the {@link android.R.attr#launchMode} attribute.
public int
launchMode
The launch mode style requested by the activity. From the {@link android.R.attr#launchMode} attribute, one of {@link #LAUNCH_MULTIPLE}, {@link #LAUNCH_SINGLE_TOP}, {@link #LAUNCH_SINGLE_TASK}, or {@link #LAUNCH_SINGLE_INSTANCE}.
public String
permission
Optional name of a permission required to be able to access this Activity. From the "permission" attribute.
public String
taskAffinity
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 {@link android.R.attr#taskAffinity} attribute.
public String
targetActivity
If this is an activity alias, this is the real activity class to run for it. Otherwise, this is null.
public static final int
FLAG_MULTIPROCESS
Bit in {@link #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 {@link #processName}. Set from the {@link android.R.attr#multiprocess} attribute.
public static final int
FLAG_FINISH_ON_TASK_LAUNCH
Bit in {@link #flags} indicating that, when the activity's task is relaunched from home, this activity should be finished. Set from the {@link android.R.attr#finishOnTaskLaunch} attribute.
public static final int
FLAG_CLEAR_TASK_ON_LAUNCH
Bit in {@link #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 {@link android.R.attr#clearTaskOnLaunch} attribute.
public static final int
FLAG_ALWAYS_RETAIN_TASK_STATE
Bit in {@link #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 {@link android.R.attr#alwaysRetainTaskState} attribute.
public static final int
FLAG_STATE_NOT_NEEDED
Bit in {@link #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 {@link android.R.attr#stateNotNeeded} attribute.
public static final int
FLAG_EXCLUDE_FROM_RECENTS
Bit in {@link #flags} that indicates that the activity should not appear in the list of recently launched activities. Set from the {@link android.R.attr#excludeFromRecents} attribute.
public static final int
FLAG_ALLOW_TASK_REPARENTING
Bit in {@link #flags} that indicates that the activity can be moved between tasks based on its task affinity. Set from the {@link android.R.attr#allowTaskReparenting} attribute.
public static final int
FLAG_NO_HISTORY
Bit in {@link #flags} indicating that, when the user navigates away from an activity, it should be finished. Set from the {@link android.R.attr#noHistory} attribute.
public int
flags
Options that have been set in the activity declaration in the manifest: {@link #FLAG_MULTIPROCESS}, {@link #FLAG_FINISH_ON_TASK_LAUNCH}, {@link #FLAG_CLEAR_TASK_ON_LAUNCH}, {@link #FLAG_ALWAYS_RETAIN_TASK_STATE}, {@link #FLAG_STATE_NOT_NEEDED}, {@link #FLAG_EXCLUDE_FROM_RECENTS}, {@link #FLAG_ALLOW_TASK_REPARENTING}, {@link #FLAG_NO_HISTORY}.
public static final int
SCREEN_ORIENTATION_UNSPECIFIED
Constant corresponding to unspecified in the {@link android.R.attr#screenOrientation} attribute.
public static final int
SCREEN_ORIENTATION_LANDSCAPE
Constant corresponding to landscape in the {@link android.R.attr#screenOrientation} attribute.
public static final int
SCREEN_ORIENTATION_PORTRAIT
Constant corresponding to portrait in the {@link android.R.attr#screenOrientation} attribute.
public static final int
SCREEN_ORIENTATION_USER
Constant corresponding to user in the {@link android.R.attr#screenOrientation} attribute.
public static final int
SCREEN_ORIENTATION_BEHIND
Constant corresponding to behind in the {@link android.R.attr#screenOrientation} attribute.
public static final int
SCREEN_ORIENTATION_SENSOR
Constant corresponding to sensor in the {@link android.R.attr#screenOrientation} attribute.
public static final int
SCREEN_ORIENTATION_NOSENSOR
Constant corresponding to sensor in the {@link android.R.attr#screenOrientation} attribute.
public int
screenOrientation
The preferred screen orientation this activity would like to run in. From the {@link android.R.attr#screenOrientation} attribute, one of {@link #SCREEN_ORIENTATION_UNSPECIFIED}, {@link #SCREEN_ORIENTATION_LANDSCAPE}, {@link #SCREEN_ORIENTATION_PORTRAIT}, {@link #SCREEN_ORIENTATION_USER}, {@link #SCREEN_ORIENTATION_BEHIND}, {@link #SCREEN_ORIENTATION_SENSOR}, {@link #SCREEN_ORIENTATION_NOSENSOR}.
public static final int
CONFIG_MCC
Bit in {@link #configChanges} that indicates that the activity can itself handle changes to the IMSI MCC. Set from the {@link android.R.attr#configChanges} attribute.
public static final int
CONFIG_MNC
Bit in {@link #configChanges} that indicates that the activity can itself handle changes to the IMSI MNC. Set from the {@link android.R.attr#configChanges} attribute.
public static final int
CONFIG_LOCALE
Bit in {@link #configChanges} that indicates that the activity can itself handle changes to the locale. Set from the {@link android.R.attr#configChanges} attribute.
public static final int
CONFIG_TOUCHSCREEN
Bit in {@link #configChanges} that indicates that the activity can itself handle changes to the touchscreen type. Set from the {@link android.R.attr#configChanges} attribute.
public static final int
CONFIG_KEYBOARD
Bit in {@link #configChanges} that indicates that the activity can itself handle changes to the keyboard type. Set from the {@link android.R.attr#configChanges} attribute.
public static final int
CONFIG_KEYBOARD_HIDDEN
Bit in {@link #configChanges} that indicates that the activity can itself handle changes to the keyboard being hidden/exposed. Set from the {@link android.R.attr#configChanges} attribute.
public static final int
CONFIG_NAVIGATION
Bit in {@link #configChanges} that indicates that the activity can itself handle changes to the navigation type. Set from the {@link android.R.attr#configChanges} attribute.
public static final int
CONFIG_ORIENTATION
Bit in {@link #configChanges} that indicates that the activity can itself handle changes to the screen orientation. Set from the {@link android.R.attr#configChanges} attribute.
public static final int
CONFIG_FONT_SCALE
Bit in {@link #configChanges} that indicates that the activity can itself handle changes to the font scaling factor. Set from the {@link android.R.attr#configChanges} attribute. This is not a core resource configutation, but a higher-level value, so its constant starts at the high bits.
public int
configChanges
Bit mask of kinds of configuration changes that this activity can handle itself (without being restarted by the system). Contains any combination of {@link #CONFIG_FONT_SCALE}, {@link #CONFIG_MCC}, {@link #CONFIG_MNC}, {@link #CONFIG_LOCALE}, {@link #CONFIG_TOUCHSCREEN}, {@link #CONFIG_KEYBOARD}, {@link #CONFIG_NAVIGATION}, and {@link #CONFIG_ORIENTATION}. Set from the {@link android.R.attr#configChanges} attribute.
public int
softInputMode
The desired soft input mode for this activity's main window. Set from the {@link android.R.attr#windowSoftInputMode} attribute in the activity's manifest. May be any of the same values allowed for {@link android.view.WindowManager.LayoutParams#softInputMode WindowManager.LayoutParams.softInputMode}. If 0 (unspecified), the mode from the theme will be used.
public static final Parcelable.Creator
CREATOR
Constructors Summary
public ActivityInfo()
public ActivityInfo(ActivityInfo orig)

        super(orig);
        theme = orig.theme;
        launchMode = orig.launchMode;
        permission = orig.permission;
        taskAffinity = orig.taskAffinity;
        targetActivity = orig.targetActivity;
        flags = orig.flags;
        screenOrientation = orig.screenOrientation;
        configChanges = orig.configChanges;
        softInputMode = orig.softInputMode;
private ActivityInfo(android.os.Parcel source)


       
        super(source);
        theme = source.readInt();
        launchMode = source.readInt();
        permission = source.readString();
        taskAffinity = source.readString();
        targetActivity = source.readString();
        flags = source.readInt();
        screenOrientation = source.readInt();
        configChanges = source.readInt();
        softInputMode = source.readInt();
Methods Summary
public intdescribeContents()

        return 0;
public voiddump(android.util.Printer pw, java.lang.String prefix)

        super.dumpFront(pw, prefix);
        pw.println(prefix + "permission=" + permission);
        pw.println(prefix + "taskAffinity=" + taskAffinity
                + " targetActivity=" + targetActivity);
        pw.println(prefix + "launchMode=" + launchMode
                + " flags=0x" + Integer.toHexString(flags)
                + " theme=0x" + Integer.toHexString(theme));
        pw.println(prefix + "screenOrientation=" + screenOrientation
                + " configChanges=0x" + Integer.toHexString(configChanges)
                + " softInputMode=0x" + Integer.toHexString(softInputMode));
        super.dumpBack(pw, prefix);
public final intgetThemeResource()
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.

return
The theme associated with this activity.

        return theme != 0 ? theme : applicationInfo.theme;
public java.lang.StringtoString()

        return "ActivityInfo{"
            + Integer.toHexString(System.identityHashCode(this))
            + " " + name + "}";
public voidwriteToParcel(android.os.Parcel dest, int parcelableFlags)

        super.writeToParcel(dest, parcelableFlags);
        dest.writeInt(theme);
        dest.writeInt(launchMode);
        dest.writeString(permission);
        dest.writeString(taskAffinity);
        dest.writeString(targetActivity);
        dest.writeInt(flags);
        dest.writeInt(screenOrientation);
        dest.writeInt(configChanges);
        dest.writeInt(softInputMode);