C H A P T E R 1 9
Built-in Applications and System Data
Deleting Meetings and Events
The Dates application provides three methods for deleting meetings or events:
These three methods all take the same parameters, as in
meeting or event to be deleted can be identified in one of two ways:
By matching the title (in the mtgTextOrFrame parameter) and the start date (in
the mtgStartDate parameter) of the meeting or event.
By passing in a meeting frame for the mtgTextOrFrame parameter. A meeting
frame can be obtained either by calling one of two searching methods
) described in
"Finding Meetings or Events" (page 19-13), or by querying one of the Dates
soups, described in "Dates Soup Formats" (page 16-56) in Newton
As is explained in "Using the Dates Soups" (page 19-22), repeating meetings and
events are stored as a single soup entry (meeting frame) in either the "Repeat
Meetings" or "Repeat Notes" soups. Calling
with a meeting title and start date (as in the first bullet above)
deletes only that instance of a repeating meeting or event. However, calling one of
these methods with a meeting frame (as in the second bullet above) stored in one of
these two soups deletes the entire series.
entire series of repeating events or meetings, regardless of whether a meeting frame
or the title and start date of an event or meeting is used.
Here are some examples of deleting meetings or events of different types:
To delete a meeting by title/start time:
GetRoot().calendar:DeleteAppointment ("lunch with Ellen",
StringToDate("6/30/95 11:30am"), true);
To delete the same meeting passing in a meeting frame returned by
("lunch with Ellen",
// these last two params. are ignored when
nil); // supplying a meeting frame.