Tasks

From Pointui

This is a Global object. You must not create an instance of it as one is always available for your use.

Provides access to the user’s tasks available within the device.

Methods

void GetTasks(DataTable result)

Returns the entire list of tasks including completed tasks. The DataTable “result” will be set to contain the tasks, which could be zero or more.

The DataTable supports the following columns:

EXAMPLE

DataTable tasks;
Tasks.GetTasks(tasks);
while (tasks.MoveNext())
{
	//do something with the tasks
}

void GetCategories(DataTable result)

AVAILABLE SINCE: 2.1 Fills the result DataTable with the list of task categories.

void Display(int objectID)

Displays the default OS screen for a specific task. Each task has a unique id which can be retrieved using DataTable.GetValue(“ObjectID”).

PARAMETERS

• objectID – the unique ID of the task object.

EXAMPLE

//get tasks
DataTable tasks;
Tasks.GetTasks(tasks);
//move to first task
tasks.MoveNext();
//get the unique id for the task
int oid;
tasks.GetValue(“ObjectID”, oid);
//display the OS screen for this task
Tasks.Display(oid);

void DisplayApp()

Displays the default OS task application.

EXAMPLE

Tasks.DisplayApp();

void Create(Task result)

Creates a new task with no properties set, not even a name or unique ObjectID. Before an ObjectID property value can be retrieved the resulting Task object must have it’s Save() method called. Also, other methods such as Display() may fail on the resulting Task object if called before Save().