Apple Newton Programmer’s Newton 2.0 (for Newton 2.0) - Manual (Page 699)

C H A P T E R 1 9
Built-in Applications and System Data
To Do List 19-25
GetToDoItemsForThisDate returns an array of tasks. Tasks are elements of
the array stored in the topics slot of a day’s soup entry. For the structure of these
frames, see “To Do List Soup Format” (page 16-77) in Newton Programmer’s
Reference. The following code example obtains today’s tasks:
todaysTasksArray := GetRoot().calendar:GetToDo():
GetToDoItemsForThisDate(time());
GetToDoEntry returns an array of soup entries for a specific day. Since the To
Do List stores tasks in a soup entry for each day, this array will contain an element
for each store that has a task stored under that day. The following code example
obtains today’s soup entries:
todaysEntries := GetRoot().calendar:GetToDo():
GetToDoEntry(time(),nil);
Note
The GetToDoEntry method requires that the To Do
List be open. ◆
GetToDoItemsForRange returns an array of frames for each day in the range
passed in. The following code example retrieves the tasks for the next seven days:
nextWeeksTasks := GetRoot().calendar:GetToDo():
GetToDoItemsForRange(time(), time() + 7*24*60);
There is also a To Do List method, NextToDoDate( date ), which returns the
date of the next task on or after date . This method can be useful in this context.
Checking-Off a Task 19
A tasks is marked as completed with the To Do List method SetDone . This
method requires the To Do List to be open; you can make sure the To Do List is
open by calling the Dates method
DisplayDate . The following code sample
marks off a task:
//open Dates and make it show today’s To Do List
GetRoot().calendar:Open();
GetRoot().calendar:DisplayDate(time(),'toDoList);
//get a reference to today’s tasks
todaysTasksArray := GetRoot().calendar:GetToDo():
GetToDoItemsForThisDate(time());
//find a task that says "test"
for i := 0 to length(todaysTasksArray) - 1 do
if StrEqual (todaysTasksArray[i].text, "test") then