|
Home · All Namespaces · All Classes · Grouped Classes · Modules · Functions | |
The QTask class holds the data of a task (to-do list) entry. More...
#include <QTask>
Inherits QPimRecord.
The QTask class holds the data of a task (to-do list) entry.
A QTask stores several pieces of information about a task and its progress, including:
The progress of a task is tracked in a number of ways:
These progress fields are interrelated. Setting one field may cause a change in other fields, since QTask will manage the dependencies between them automatically. These dependencies include:
These dependencies work in both directions. For example:
See also Status, Priority, and Pim Library.
These values describe the current priority() of the Task.
The values are:
| Constant | Value |
|---|---|
| QTask::VeryHigh | 1 |
| QTask::High | 2 |
| QTask::Normal | 3 |
| QTask::Low | 4 |
| QTask::VeryLow | 5 |
These values describe the current status() of the Task.
The values are:
| Constant | Value | Description |
|---|---|---|
| QTask::NotStarted | 0 | the task has not been started yet (0% complete, no started or completed dates) |
| QTask::InProgress | 1 | the task has a startedDate (but no completedDate), and percentCompleted is between 0 and 99 inclusive |
| QTask::Completed | 2 | the task has a startedDate and a completedDate, and percentCompleted is 100 |
| QTask::Waiting | 3 | similar to InProgress |
| QTask::Deferred | 4 | similar to InProgress |
Creates a new, empty task.
Constructs a QTask as a copy of other.
Destroys the task
Clears the due date of the task.
See also setDueDate().
Returns the date the task was completed. If the task is not completed, the returned date is null.
See also isCompleted() and setCompletedDate().
Returns the description of the task.
See also setDescription().
Returns the due date of the task.
See also setDueDate() and clearDueDate().
Returns true if there is a due date set for the task. Otherwise returns false.
See also dueDate(), setDueDate(), and clearDueDate().
Returns true if the task has a started date.
See also startedDate() and setStartedDate().
Returns true if the task is completed. Otherwise returns false.
See also setCompleted().
Returns true if this task matches regular expression r. Otherwise returns false.
This is intended to allow the user to enter text to find matching tasks.
The expression will be matched against the following fields:
Returns the notes for the task.
Reimplemented from QPimRecord.
See also setNotes().
Returns progress of the task as a percent completed. For tasks that have not been started, this will return 0, and for completed tasks, this function will always return 100.
See also setPercentCompleted() and status().
Returns the priority of the task.
See also setPriority().
Reads a list of vCalendars from the given device and returns the equivalent set of tasks.
See also writeVCalendar().
This function is deprecated.
This is an overloaded member function, provided for convenience.
Reads the file specified by filename as a list of vCalendar objects and returns a list of QTasks that correspond to the data. Note that some vCalendar properties may not be supported by QTask.
See also writeVCalendar().
This function is deprecated.
This is an overloaded member function, provided for convenience.
Reads the given vCalendar data in vcal and returns the list of corresponding QTasks.
See also writeVCalendar().
This function is deprecated.
Reads the data of len bytes as a list of vCalendar objects and returns the list of corresponding QTasks.
See also writeVCalendar() and readVCalendar().
If b is true, marks the task as completed, and otherwise marks the task as incomplete.
Several fields are dependent on the new completion state:
See also isCompleted() and completedDate().
Sets the tasks completed date to date. If date is null, and the task was previously completed, then the task will be marked as having status InProgress, and the percentage completed will be forced to 99%. In addition, if the task's started date was not previously set, it will be set to the supplied date.
See also isCompleted() and completedDate().
Sets the description of the task to description.
See also description().
Sets the due date of the task to date.
See also clearDueDate() and dueDate().
Sets the notes of the task to notes.
Reimplemented from QPimRecord.
See also notes().
Sets the tasks percent completed field to percent.
The task's status field depends on the new percentage complete value in the following ways:
See also percentCompleted() and status().
Sets the priority of the task to priority.
See also priority().
This is an overloaded member function, provided for convenience.
Sets the priority of the task to priority. This is a convenience wrapper function.
See also priority().
Sets the tasks to have started on date. If date is null, then the task will be marked as having status NotStarted, any completed date will be cleared, and the percentage completed will be 0.
See also hasStartedDate() and startedDate().
Sets the Status of the task to status.
If the new status is NotStarted, the task's started date will be cleared. Otherwise, if the task was not previously started, the current date will be used as the task's starting date.
Similarly, if the new status Completed and the task was not previously completed, then the current date will be used as the task's completed date. Otherwise, if the new status is not Completed, the completed date will be cleared.
If a task's status is Completed, the percent completed will be set to 100%. Otherwise, the percent completed is limited to a maximum of 99%.
See also status().
This is an overloaded member function, provided for convenience.
Sets the Status of the task to status. This is a convenience wrapper function.
See also status().
Returns the date the task was started. If the task has not yet been started, the returned date is null.
See also hasStartedDate() and setStartedDate().
Returns the Status of the task.
See also setStatus().
Returns the translated text for the the task status status.
Returns a rich text formatted QString of the QTask.
Writes the given list of tasks to the given device as vCalendars.
Returns true on success.
See also readVCalendar().
This is an overloaded member function, provided for convenience.
Writes the given task to the given device as vCalendars.
Returns true on success.
See also readVCalendar().
This function is deprecated.
This is an overloaded member function, provided for convenience.
Write the list of tasks as vCalendar objects to the file specified by filename.
See also readVCalendar().
This function is deprecated.
This is an overloaded member function, provided for convenience.
Write the task as a vCalendar to the file specified by filename.
See also readVCalendar().
This function is deprecated.
This is an overloaded member function, provided for convenience.
Writes this task as a vCalendar object to the file specified by filename.
See also readVCalendar().
This function is deprecated.
This is an overloaded member function, provided for convenience.
Writes this task as a vCalendar object to the given file, which must be already open for writing.
See also readVCalendar().
This function is deprecated.
This is an overloaded member function, provided for convenience.
Writes this task as a vCalendar object to the given stream, which must be writable.
See also readVCalendar().
Returns false if other is identical to this task. Otherwise return true.
Sets the task to be a copy of other.
Returns true if other is identical to this task. Otherwise return false.
| Copyright © 2009 Nokia | Trademarks | Qt Extended 4.4.3 |