ActivityManager.AppTask

The AppTask allows you to manage your own application's tasks. See getAppTasks()

Summary

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 `FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS` flag in the root Intent of this AppTask.
void	startActivity(Context context, Intent intent, Bundle options) Start an activity in this task.

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 FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS flag in the root Intent of this AppTask.

void

startActivity(Context context, Intent intent, Bundle options)

Start an activity in this task.

[Expand]

Inherited Methods

From class java.lang.Object

Object	clone() Creates and returns a copy of this `Object`.
boolean	equals(Object o) Compares this instance with the specified object and indicates if they are equal.
void	finalize() Invoked when the garbage collector has detected that this instance is no longer reachable.
final Class<?>	getClass() Returns the unique instance of `Class` that represents this object's class.
int	hashCode() Returns an integer hash code for this object.
final void	notify() Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
final void	notifyAll() Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
String	toString() Returns a string containing a concise, human-readable description of this object.
final void	wait() Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object.
final void	wait(long millis, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.
final void	wait(long millis) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.

Public Methods

public void finishAndRemoveTask ()

Added in API level 21

Finishes all activities in this task and removes it from the recent tasks list.

public ActivityManager.RecentTaskInfo getTaskInfo ()

Added in API level 21

Get the RecentTaskInfo associated with this task.

Returns

The RecentTaskInfo for this task, or null if the task no longer exists.

public void moveToFront ()

Added in API level 21

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.

public void setExcludeFromRecents (boolean exclude)

Added in API level 21

Modify the FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS flag in the root Intent of this AppTask.

Parameters

exclude	If true, `FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS` will be set; otherwise, it will be cleared.

public void startActivity (Context context, Intent intent, Bundle options)

Added in API level 21

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

intent	The Intent describing the new activity to be launched on the task.
options	Optional launch options.

Results

Interfaces

Classes

Exceptions

Class Overview

Summary

Public Methods

public void finishAndRemoveTask ()

public ActivityManager.RecentTaskInfo getTaskInfo ()

Returns

public void moveToFront ()

public void setExcludeFromRecents (boolean exclude)

Parameters

public void startActivity (Context context, Intent intent, Bundle options)

Parameters

See Also

java.lang.Object
↳	android.app.ActivityManager.AppTask