RDOException object

 

RDOException represents an exception in the recurrence pattern of a recurring appointment .

 

Returned by:

RDOExceptions.Item

 

The example below lists all exceptions of a recurring appointment.

set Pattern = Appointment.GetRecurrencePattern
set Exceptions = Pattern.Exceptions
for each Exception in Exceptions
    Debug.Print "Original date: " & Exception.OriginalDate
    set Item = Exception.Item
    if not Item Is Nothing Then 'it can be NULL if it is a deleted exception
        Debug.Print "New date: " & Item.Start
    End If
next

 

Properties

Methods

 


Derived from: IDispatch


Properties


The ChangeHighlight* properties read the change-highlight flags stored in the recurrence exception. Each property is True when its corresponding flag is set. They do not compare the exception with the master appointment, and a missing flag does not establish that a field is unchanged. These flags can be read without opening Item.

ChangeHighlightStart

Boolean, read-only.

True if the stored change-highlight flag for the start time is set.

 
ChangeHighlightEnd

Boolean, read-only.

True if the stored change-highlight flag for the end time is set.

 
ChangeHighlightRecurrence

Boolean, read-only.

True if the stored change-highlight flag for the recurrence pattern is set.

 
ChangeHighlightLocation

Boolean, read-only.

True if the stored change-highlight flag for the location is set.

 
ChangeHighlightSubject

Boolean, read-only.

True if the stored change-highlight flag for the subject is set.

 
ChangeHighlightRequiredAttendees

Boolean, read-only.

True if the stored change-highlight flag for the required attendees is set.

 
ChangeHighlightOptionalAttendees

Boolean, read-only.

True if the stored change-highlight flag for the optional attendees is set.

 
ChangeHighlightBody

Boolean, read-only.

True if the stored change-highlight flag for the body is set.

 
ChangeHighlightResponse

Boolean, read-only.

True if the stored change-highlight flag for the response setting is set.

 
ChangeHighlightAllowPropose

Boolean, read-only.

True if the stored change-highlight flag for the setting allowing attendees to propose a new time is set.

 
ChangeHighlightConference

Boolean, read-only.

True if the stored change-highlight flag for the conference information is set.

 
ChangeHighlightReminder

Boolean, read-only.

True if the stored change-highlight flag for the reminder is set.

 

Deleted

Boolean, read-only. True if if the exception is deleted. False if changed.
 

 

EndDateTime

DateTime, read-only. Returns the end date and time of the appointment.

Can be 1/1/4501 if the end date is not set in the recurrence blob (usually for appointments created using old versions of Outlook).

 

 

Item

RDOMail, read-only. Returns the appointment corresponding to the exception. If the instance was deleted (Deleted property is true), NULL is returned

 

 

ModifiedAppointmentColor

Integer, read-only.

Returns the exception color if different from the master appointment.

Valid only if OverrideAppointmentColor property is true.

 

 

ModifiedAttachment

Boolean, read-only.

Valid only if OverrideAttachment property is true.

 

 

 

ModifiedBusyStatus

rdoBusyStatus, read-only.

Returns the exception busy status if different from the master appointment.

Valid only if OverrideBusyStatus property is true.

 

 

ModifiedLocation

String, read-only.

Returns the exception location if different from the master appointment.

Valid only if OverrideLocation property is true.

 

 

ModifiedMeetingType

Integer, read-only.

Returns the exception meeting type if different from the master appointment.

Valid only if OverrideMeetingType property is true.

 

 

ModifiedReminderDelta

Integer, read-only.

Returns the exception reminder minutes before start if different from the master appointment.

Valid only if OverrideReminderDelta property is true.

 

 

ModifiedReminderSet

Boolean, read-only.

Returns the exception reminder if different from the master appointment.

Valid only if OverrideReminderSet property is true.

 

 

ModifiedSubject

String, read-only.

Returns the exception subject if different from the master appointment.

Valid only if OverrideSubject property is true.

 

 

ModifiedSubType

Integer, read-only.

Returns the exception meeting subtype if different from the master appointment.

Valid only if OverrideSubType property is true.

 

 

OriginalDate

DateTime, read-only. Returns the original date of the recurrence instance. If the instance was modified (rather than deleted), retrieve the exception appointment using the Item property and read the Start property (see the example above)

 

 

OriginalStartDate

DateTime, read-only. Returns the original date and time of the appointment.

Can be 1/1/4501 if the original date is not set in the recurrence blob (usually for appointments created using old versions of Outlook).

 

 

 

OverrideAppointmentColor

Boolean, read-only.

True if the exception has color different from the master appointment.

 

 

OverrideAttachment

Boolean, read-only.

True if the exception has attachments different from the master appointment.

 

 

OverrideBody

Boolean, read-only.

True if the exception has the body-override flag set in its recurrence data. This indicates an exceptional body and can be read without opening Item.

If Exception.OverrideBody Then
  Debug.Print "Exception body overridden"
End If

OverrideBusyStatus

Boolean, read-only.

True if the exception has busy status different from the master appointment.

 

 

OverrideLocation

Boolean, read-only.

True if the exception has location different from the master appointment.

 

 

OverrideMeetingType

Boolean, read-only.

True if the exception has meeting type different from the master appointment.

 

 

OverrideReminderDelta

Boolean, read-only.

True if the exception has reminder time different from the master appointment.

 

 

OverrideReminderSet

Boolean, read-only.

True if the exception has reminder different from the master appointment.

 

 

OverrideSubject

Boolean, read-only.

True if the exception has subject different from the master appointment.

 

 

OverrideSubType

Boolean, read-only.

True if the exception has sub type different from the master appointment.

 

 

StartDateTime

DateTime, read-only. Returns the start date and time of the appointment.

Can be 1/1/4501 if the start date is not set in the recurrence blob (usually for appointments created using old versions of Outlook).

 

 

 


Methods


Restore
Restores this exception to the original state (no exception on this date).
The exception is removed from the parent RDOExceptions collection; attempting to use the RDOException object after calling this method will result in an error.