This documentation is archived and is not being maintained.

TimelineView Interface

Represents a view that displays Outlook items in a timeline.

Namespace:  Microsoft.Office.Interop.Outlook
Assembly:  Microsoft.Office.Interop.Outlook (in Microsoft.Office.Interop.Outlook.dll)

public interface TimelineView : _TimelineView

This is a .NET interface derived from a COM coclass that is required by managed code for interoperability with the corresponding COM object. Use this derived interface to access all method, property, and event members of the COM object. However, if a method or event you want to use shares the same name under the same COM object, cast to the corresponding primary interface to call the method, and cast to the latest events interface to connect to the event. Refer to this topic for information about the COM object. For information about the method and property members of the COM object, see _TimelineView.

The TimelineView object, derived from the View object, allows you to create customizable views that allow you to display Outlook items within a timeline.

Outlook provides several built-in TimelineView objects, and you can also create custom TimelineView objects. Use the Add method of the Views collection to add a new TimelineView to a Folder object. Use the Standard property to determine if an existing TimelineView object is built-in or custom.

The TimelineView object supports several different view modes, depending on the desired layout and time period in which to display Outlook items. Use the TimelineViewMode property to set the view mode, the StartField property to specify the Outlook item property that contains the start date, and the EndField property to specify the Outlook item property that contains the end date for Outlook items to be displayed.

You can configure the appearance of the TimelineView, depending on the view mode. Use the ShowWeekNumbers property to indicate whether week numbers are displayed in the time scale for the view. Use the UpperScaleFont and LowerScaleFont properties to specify the font used when displaying, respectively, the upper and lower portions of the time scale for the view.

You can also configure how Outlook items appear within the TimelineView object. Use the ItemFont property to specify the font used to display Outlook item labels and the MaxLabelWidth property to specify the length of labels for Outlook items in the view. Use the DefaultExpandCollapseSetting property to determine if Outlook items are expanded by default in the view. Use the Filter property to determine which Outlook items to display in the view and the GroupByFields collection to specify the Outlook item properties by which Outlook items are grouped in the view. If you set the TimelineViewMode to olTimelineViewMonth, you can use the ShowLabelWhenViewingByMonth property to determine if labels for Outlook items are displayed in the view.

The definition for each TimelineView object is stored in Extensible Markup Language (XML) format. Use the XML property to work with the XML definition for the TimelineView object.

Use the Apply method to apply any changes made to the TimelineView object to the current view. Use the Save method to persist any changes made to the TimelineView object. Use the LockUserChanges property to allow or prevent changes to the user interface for the view.

You can change built-in TimelineView objects, but you cannot delete them. Use the Delete method to delete a custom TimelineView object. Use the Reset method to reset the properties of a built-in TimelineView object to their default values.