background image
C H A P T E R 1 9
Built-in Applications and System Data
19-24
To Do List
Also, note that some of these methods only work when the To Do List is open. You
can ensure the To Do List is open by calling the Dates method
DisplayDate
passing in
'toDoList
for the format parameter as in the following code:
//open Dates and make it show today's To Do List
GetRoot().calendar:Open();
GetRoot().calendar:DisplayDate(time(),'toDoList);
This section describes
creating and removing To Do tasks
accessing tasks
checking-off tasks
using miscellaneous To Do List methods
using the To Do List soup
Creating and Removing Tasks
19
There are two To Do List methods that add a task:
CreateToDoItem
and
CreateToDoItemAll
. The
CreateToDoItem
method takes four parameters, as
in
CreateToDoItem(
date
,
richString
,
reminder
,
frequency
)
. The
CreateToDoItemAll
method takes two additional parameters, priority and
completed, which set the priority and completion status of the new task.
The following code example adds a task to today's To Do List:
GetRoot().calendar:GetToDo():CreateToDoItem (time(),
"test", nil, nil);
The To Do List
GetToDoEntry
method (discussed in "Accessing Tasks" beginning
on page 19-24) will also create a soup entry if one does not exist for that date.
To remove tasks, use the To Do List method
RemoveOldToDoItems
, which
removes either all or those tasks that have been marked-off before a specific date.
The following code sample removes all the nonrepeating To Do List tasks in the
twentieth century:
GetRoot().calendar:GetToDo():
RemoveOldToDoItems(StringToDate("1/1/2000"),'all,nil);
Accessing Tasks
19
The To Do List provides three methods for accessing tasks:
GetToDoItemsForThisDate
GetToDoEntry
GetToDoItemsForRange
.
© 2007-2017, o7 studio » при воспроизведении материала сайта ссылка обязательна