IAppointment Property Methods
These methods are not supported in Windows CE Platform Builder 3.0.
The property methods of the IAppointment interface read the properties described in the following table. For more information, see Interface Property Methods.
Properties in Vtable Order
||Returns or sets the subject for the appointment. This string is limited to 4096 characters.|
||Returns or sets the location for an appointment. Maximum length is 1023 characters.|
||Returns or sets the categories assigned to the appointment.|
||Returns or sets when an appointment starts. This must be set before or equal to the End property. Dates must be set between 1/1/1900 and 12/31/2999 inclusive. The default start time is the next hour — for example, if the current time is 10:37 AM, the default start time is 11:00 AM.|
||Returns or sets the length of an appointment. The maximum duration is 31 days. The default duration is one hour.|
||Returns or sets when the appointment ends. This must be set equal to or after the Start property. Dates must be set between 1/1/1900 and 12/31/2999 inclusive.|
||Returns or sets whether an appointment is an all day event. If TRUE, the appointment cannot be a meeting. The default for this is FALSE.|
||Returns whether the appointment is recurring. This is useful to use in a restriction string, to quickly discern whether or not an appointment is recurring.|
||Returns whether the appointment is a meeting (olMeeting) or not (olNotMeeting). In Pocket Outlook you do not set this to indicate a meeting. Pocket Outlook automatically sets MeetingStatus for any appointment with recipients to olMeeting.|
||Returns or sets the sensitivity for a meeting as normal (olNormal) or private (olPrivate). The default setting for a new appointment is olNormal.|
||Returns or sets a user's availability during an appointment. You can set this property to display a user's availability as Busy (olBusy), Free (olFree), Out of Office (olOutOfOffice), or Tentative (olTentative). The default for a new appointment is olBusy.|
||Returns or sets whether the user wants to be reminded of an appointment. The default for this is the user setting in the Calendar Options dialog box.|
||Returns or sets the path and file name of the sound file to play when the reminder occurs for the appointment. This property is valid only if the ReminderSet property is TRUE and the ReminderOptions property includes olSound. The default for this is the current setting for the Calendar application or Alarm1.wav if none.
Maximum length is 255 characters.
||Returns or sets the type of a reminder. Sum of any of the following constants:
olLED activates the LED (light emitting diode) on a device.
olVibrate activates any vibration indicator on a device.
olDialog displays a dialog.
olSound plays the file specified by ReminderSoundFile.
olRepeat repeats the reminder.
Sum different options to simultaneously provide multiple types of reminders. Note that the setting this property clears any previous setting.
Because Windows CE devices support several notification options not supported by desktop computers (such as flashing LED or vibration), this property replaces the Outlook ReminderPlaySound property.
||Returns or sets the number of minutes a reminder occurs before the start of an appointment. The default for this is the user setting in the Calendar Options dialog box.|
||Returns the recipients list as an IRecipients objects. Use the methods for the IRecipients object to get, add or remove recipients in the recipients list.|
||Returns or sets notes or message accompanying an appointment. The maximum size is 20 KB.|
||Returns or sets a Binary Large Object (BLOB) describing the Ink Note information. The properties Body and InkBody both access the same property. The Body returns only the string value of the Body while the BodyInk property returns an Ink BLOB that can be set to an Ink Control.|
||Returns an Application object that represents the parent application (Pocket Outlook) for the item.|
||Returns the object identifier (OID) for an item. This may be necessary for replication services.|
Each property method supports the standard HRESULT return values, including S_OK.
Pocket Outlook's does not support the desktop Outlook's ReminderOverrideDefault property. When you create an appointment, Pocket Outlook automatically creates it with the default reminder information. When you set individual reminder properties, they automatically override the defaults.
In the desktop Outlook, you must set the MeetingStatus property of an appointment to mark it as a meeting request. This allows you to have appointments with recipients that are not meeting requests. This is not possible in Pocket Outlook. In Pocket Outlook, an appointment is a meeting request if it has a Recipients. The MeetingStatus property is a read only property and can only assume the values olNonMeeting or olMeeting.
In the desktop Outlook, the Address property is read-only. In Pocket Outlook it is both read and write. This is because Pocket Outlook does not provide a Resolve method to resolve the display name to an e-mail address.
In order to send a cancellation to a meeting in the desktop Outlook, you must first set the MeetingStatus property to olMeetingCanceled. This property is read-only in Pocket Outlook, so you must use the Cancel method to send a cancellation method for a meeting. Note that you must subsequently call the Item collection's Delete method to remove the meeting from the user's calendar.
Last updated on Tuesday, July 13, 2004
© 1992-2000 Microsoft Corporation. All rights reserved.