com.sun.ams

Interface TaskManager

public interface TaskManager

TaskManager interface

Method Summary

Methods

Modifier and Type	Method and Description
TaskInfo	getCurrentTask() Returns a descriptor of the task the caller belongs to.
TaskInfo	getForegroundTask() Returns foreground task.
TaskInfo[]	getTaskList(boolean includeSystem) Returns an array of running tasks.
void	setStatusListener(TaskManagerListener theListener) Assigns the task status update listener
TaskInfo	startTask(java.lang.String suiteName, java.lang.String vendorName, java.lang.String className) Starts task with given parameters.
TaskInfo	startTaskWithOptions(java.lang.String suiteName, java.lang.String vendorName, java.lang.String className, int options) Starts task with given parameters and options.

Method Detail

startTask

TaskInfo startTask(java.lang.String suiteName,
                 java.lang.String vendorName,
                 java.lang.String className)

Starts task with given parameters.

Parameters:

suiteName - suite name where the task launched from

vendorName - vendor of the suite where the task launched from

className - startup class

Returns:

task descriptor or null if task can't start

startTaskWithOptions

TaskInfo startTaskWithOptions(java.lang.String suiteName,
                            java.lang.String vendorName,
                            java.lang.String className,
                            int options)

Starts task with given parameters and options.

Parameters:

suiteName - suite name where the task launched from

vendorName - vendor of the suite where the task launched from

className - startup class

options - startup task options (debug, suspend, profile - see Constants.MIDP_RUN_OPTION)

Returns:

task descriptor or null if task can't start

getForegroundTask

TaskInfo getForegroundTask()

Returns foreground task. A task is said to be in the foreground if its current Displayable is visible on the display device and if user input device events will be delivered to it.

Returns:

task descriptor or null if there is no foreground task.

getTaskList

TaskInfo[] getTaskList(boolean includeSystem)

Returns an array of running tasks.

Parameters:

includeSystem - indicates whether to include system task into list.

Returns:

the array of task descriptors

getCurrentTask

TaskInfo getCurrentTask()

Returns a descriptor of the task the caller belongs to.

Returns:

task descriptor.

setStatusListener

void setStatusListener(TaskManagerListener theListener)

Assigns the task status update listener

Parameters:

theListener - TaskManagerListener implementation or null to remove any listener