QTaskContext Class Reference
[QtMessagingModule, QtPimModule, QtTelephonyModule, QtUiModule]

Detailed Description

The QTaskContext class represents a storage context of task data.

The class can be used to perform operations that relate to a specific context of PIM data, such as tasks stored on a device in the native Qt Extended format.

Currently there is no way for applications to implement their own contexts. This feature is being considered for future versions of Qtopia.

See also QTaskModel and Pim Library.

Member Function Documentation

QTaskContext::QTaskContext ( QObject * parent = 0 )   [protected]

Constructs a QTaskContext with parent parent.

QUniqueId QTaskContext::addTask ( const QTask & task, const QPimSource & source )   [virtual]

Adds the task to the PIM data source if it is controlled by this context. If the task is successfully added, returns the new unique id for this task, otherwise returns a null id.

QTask QTaskContext::exportTask ( const QUniqueId & id, bool & ok ) const   [virtual]

Exports a single task identified by id. If successful sets ok to true, otherwise sets ok to false.

See also exportTasks().

QList<QTask> QTaskContext::exportTasks ( const QPimSource & source, bool & ok ) const   [virtual]

Exports the tasks stored in the PIM data source and returns them as a list. The source must be controlled by this context. If successful sets ok to true, otherwise sets ok to false.

There isn't necessarily going to be a one to one match to tasks in the PIM data source. Tasks may be merged or split over multiple tasks to form the list.

bool QTaskContext::importTask ( const QPimSource & source, const QTask & task )   [virtual]

Imports a single task to the PIM data source. If successful returns true, otherwise returns false.

See also importTasks().

bool QTaskContext::importTasks ( const QPimSource & source, const QList<QTask> & tasks )   [virtual]

Imports tasks and merges them with the tasks listed in the PIM data source. The source must be controlled by this context. If successful returns true, otherwise returns false.

There isn't necessarily going to be a one to one match to tasks in the PIM data source. Tasks may be merged or split over multiple tasks. Also tasks that match in name will be updated from the list rather than additional tasks created.

bool QTaskContext::removeTask ( const QUniqueId & id )   [virtual]

Removes the task with the identifier id if it exists in this context. Returns true upon success; otherwise returns false.

bool QTaskContext::updateTask ( const QTask & task )   [virtual]

Updates the task with the same identifier as task if it exists in this context. Returns true upon success; otherwise returns false.