Appointments and Meetings

Appointments and meetings are represented by AppointmentItem objects in a calendar folder’s Messages collection. The AppointmentItem class is said to derive from the Message class, which means that an AppointmentItem object is a special kind of Message object. Properties and methods that are valid for Message objects are also valid for AppointmentItem objects, with a few exceptions. Specifically, AppointmentItem objects don’t support the Forward, Reply, and ReplyAll methods.

Because the AppointmentItem object is central to reading and creating appointments and meetings, I’ll start with a discussion of its properties and methods. Subsequent sections show how to retrieve existing appointments and meetings (in Section 8.3 and Section 8.4), and how to create new ones (in Section 8.5 and Section 8.7).

AppointmentItem-Specific Properties

The AppointmentItem-specific properties are shown in the following list. They are in addition to the properties inherited from the Message class. Unless otherwise indicated, the properties are read/write:

AllDayEvent

Indicates that the appointment is an all-day or multiple-day event if set to True. The AllDayEvent property is not used on recurring appointments and meetings. Instead, use the corresponding property on the RecurrencePattern object. (The RecurrencePattern object is discussed later in this chapter.) The datatype of the AllDayEvent property is Boolean. The default for newly created appointments is False.

BusyStatus

Get CDO & MAPI Programming with Visual Basic: now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.