public
static
class
ActivityManager.AppTask
extends Object
| java.lang.Object | |
| ↳ | android.app.ActivityManager.AppTask |
The AppTask allows you to manage your own application's tasks.
See getAppTasks()
Public methods | |
|---|---|
void
|
finishAndRemoveTask()
Finishes all activities in this task and removes it from the recent tasks list. |
ActivityManager.RecentTaskInfo
|
getTaskInfo()
Get the RecentTaskInfo associated with this task. |
void
|
moveToFront()
Bring this task to the foreground. |
void
|
setExcludeFromRecents(boolean exclude)
Modify the |
void
|
startActivity(Context context, Intent intent, Bundle options)
Start an activity in this task. |
Inherited methods | |
|---|---|
 From
class
java.lang.Object
| |
void finishAndRemoveTask ()
Finishes all activities in this task and removes it from the recent tasks list.
ActivityManager.RecentTaskInfo getTaskInfo ()
Get the RecentTaskInfo associated with this task.
| Returns | |
|---|---|
ActivityManager.RecentTaskInfo |
The RecentTaskInfo for this task, or null if the task no longer exists. |
void moveToFront ()
Bring this task to the foreground. If it contains activities, they will be brought to the foreground with it and their instances re-created if needed. If it doesn't contain activities, the root activity of the task will be re-launched.
void setExcludeFromRecents (boolean exclude)
Modify the FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS flag in the root
Intent of this AppTask.
| Parameters | |
|---|---|
exclude |
boolean:
If true, FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS will
be set; otherwise, it will be cleared.
|
void startActivity (Context context, Intent intent, Bundle options)
Start an activity in this task. Brings the task to the foreground. If this task
is not currently active (that is, its id < 0), then a new activity for the given
Intent will be launched as the root of the task and the task brought to the
foreground. Otherwise, if this task is currently active and the Intent does not specify
an activity to launch in a new task, then a new activity for the given Intent will
be launched on top of the task and the task brought to the foreground. If this
task is currently active and the Intent specifies FLAG_ACTIVITY_NEW_TASK
or would otherwise be launched in to a new task, then the activity not launched but
this task be brought to the foreground and a new intent delivered to the top
activity if appropriate.
In other words, you generally want to use an Intent here that does not specify
FLAG_ACTIVITY_NEW_TASK or FLAG_ACTIVITY_NEW_DOCUMENT,
and let the system do the right thing.
| Parameters | |
|---|---|
context |
Context
|
intent |
Intent:
The Intent describing the new activity to be launched on the task. |
options |
Bundle:
Optional launch options. |
Developers