FLAG_ACTIVITY_NEW_DOCUMENT constant

This flag is used to open a document into a new task rooted at the activity launched by this Intent. Through the use of this flag, or its equivalent attribute, {@link android.R.attr#documentLaunchMode} multiple instances of the same activity containing different documents will appear in the recent tasks list.

The use of the activity attribute form of this, {@link android.R.attr#documentLaunchMode}, is preferred over the Intent flag described here. The attribute form allows the Activity to specify multiple document behavior for all launchers of the Activity whereas using this flag requires each Intent that launches the Activity to specify it.

Note that the default semantics of this flag w.r.t. whether the recents entry for it is kept after the activity is finished is different than the use of {@link #FLAG_ACTIVITY_NEW_TASK} and {@link android.R.attr#documentLaunchMode} -- if this flag is being used to create a new recents entry, then by default that entry will be removed once the activity is finished. You can modify this behavior with {@link #FLAG_ACTIVITY_RETAIN_IN_RECENTS}.

FLAG_ACTIVITY_NEW_DOCUMENT may be used in conjunction with {@link #FLAG_ACTIVITY_MULTIPLE_TASK}. When used alone it is the 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".

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

@see android.R.attr#documentLaunchMode @see #FLAG_ACTIVITY_MULTIPLE_TASK