Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 911123ac authored by Jeff Chang's avatar Jeff Chang
Browse files

Update documentation for activity flags. 

1. LAUNCHED_FROM_HISTORY, remove the out of date sentence.
2. NEW_DOCUMENT,add information about documentLaunchMode="never"
3. SINGLE_TOP, refer to launch modes for more information.

Bug: 123083574
Test: build
Change-Id: Id4da7be9993aaf1140c1c709a23ae7ed6d1718f5
parent 0b8ee9ae

core/java/android/content/Intent.java

+7 −4
Original line number Diff line number Diff line
@@ -6413,7 +6413,9 @@ public class Intent implements Parcelable, Cloneable { 
    public static final int FLAG_ACTIVITY_NO_HISTORY = 0x40000000;

    /**

     * If set, the activity will not be launched if it is already running

     * at the top of the history stack.

     * at the top of the history stack.  See

     * <a href="{@docRoot}guide/topics/fundamentals/tasks-and-back-stack.html#TaskLaunchModes">

     * Tasks and Back Stack</a> for more information.

     */

    public static final int FLAG_ACTIVITY_SINGLE_TOP = 0x20000000;

    /**
@@ -6553,8 +6555,7 @@ public class Intent implements Parcelable, Cloneable { 
    public static final int FLAG_ACTIVITY_RESET_TASK_IF_NEEDED = 0x00200000;

    /**

     * This flag is not normally set by application code, but set for you by

     * the system if this activity is being launched from history

     * (longpress home key).

     * the system if this activity is being launched from history.

     */

    public static final int FLAG_ACTIVITY_LAUNCHED_FROM_HISTORY = 0x00100000;

    /**
@@ -6587,7 +6588,9 @@ public class Intent implements Parcelable, Cloneable { 
     * equivalent of the Activity manifest specifying {@link

     * android.R.attr#documentLaunchMode}="intoExisting". When used with

     * FLAG_ACTIVITY_MULTIPLE_TASK it is the equivalent of the Activity manifest specifying

     * {@link android.R.attr#documentLaunchMode}="always".

     * {@link android.R.attr#documentLaunchMode}="always". The flag is ignored even in

     * conjunction with {@link #FLAG_ACTIVITY_MULTIPLE_TASK} when the Activity manifest specifies

     * {@link android.R.attr#documentLaunchMode}="never".

     *

     * Refer to {@link android.R.attr#documentLaunchMode} for more information.

     *