IncludeRecurrences Property

Applies To

Items collection object.

Description

True if the Items collection should include recurrence patterns. This property only has an effect if the Items collection contains appointments and is not sorted by any property other than Start in ascending order. The default value is False. Read/write Boolean.

Remarks

Use this property when you want to retrieve all appointments for a given date, where recurring appointments would not normally appear because they are not associated with any specific date. If the collection includes recurring appointments with no end date, setting the property to True may cause the collection to be of infinite count. Be sure to include a test for this in any loop.

See Also

IsRecurring property, RecurrencePattern object, RecurrenceType property.

Example

This example demonstrate how to return a specific instance of a recurring appointment.

Set myItems = myOlApp.ActiveExplorer.CurrentFolder.Items
myItems.Sort "[Start]"
myItems.IncludeRecurrences = True
MsgBox "The fifth instance of the recurring appointment occurs on:" _
    & myItems.Item(5).Start