[Expand]General Information
[Collapse]WinForms Controls
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Map Control
   [Expand]Product Information
    Getting Started
   [Expand]Scheduler Elements and Structure
   [Expand]Data Binding
     Day View
     Work Week View
     Full Week View
     Week View
     Month View
     Timeline View
     Gantt View
     Agenda View
   [Expand]Import and Export
   [Expand]Scheduler Reporting
   [Expand]Time Zones
   [Expand]Design-Time Features
   [Expand]End-User Capabilities
   [Expand]Member Tables
   [Expand]Visual Elements
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]PDF Viewer
  [Expand]TreeMap Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Timeline View

The Timeline View displays appointments as horizontal bars along the Time Scales, and provides end-users with an overview for scheduling purposes. The view is implemented by the TimelineView class, accessible by using the SchedulerControl.TimelineView property. To show the view, set the SchedulerControl.ActiveViewType property to the SchedulerViewType.Timeline type.

You can create your own time scale with a custom format and layout, and add it to the collection of Timeline scales. To accomplish this, create a descendant of one of the built-in scales, or from the base scale class TimeScaleFixedInterval. For more information, see the Time Scales article.

When switching from the Timeline view to other views, the visible interval may change. This behavior is expected because from the Timeline view can have a selected cell (the SchedulerControl.SelectedInterval) outside the currently visible interval. If you select a cell and scroll the view, the selection remains the same, although it goes beyond the visible area. When switching views, the time interval of a new view is calculated so that it starts with the interval selected in the SchedulerControl. Thus the new visible interval may be quite different from the visible interval of the Timeline view. This behavior is specific to the Timeline view.

You can bind the Resources Tree control to the SchedulerControl to display hierarchical resources. For proper display and synchronization of controls, the SchedulerViewBase.GroupType property should be set to the SchedulerGroupType.Resource value.

The following table lists the methods and properties of the TimelineView class, which implement the Timeline View's basic functionality.

Member Name


TimelineView.Appearance Provides access to the properties that control the appearance of the TimelineView's elements.
SchedulerViewBase.AppointmentDisplayOptions Provides access to the TimelineViewAppointmentDisplayOptions instance, containing the appointment's display options for the Timeline View.
SchedulerViewBase.DateTimeScrollbarVisible Hides the horizontal scrollbar in the Timeline View.

There is no equivalent WPF property.

TimelineView.GetBaseTimeScale Returns the most detailed enabled time scale. Use its TimeScale.Width property to specify the TimelineView column width.
TimelineView.OptionsSelectionBehavior Specifies how the selection behaves when the time scale is changed in the Timeline view. See OptionsSelectionBehavior.UpdateSelectionDurationAction for more information.
TimelineView.Scales Provides access to a collection of time scales displayed in the timeline view. You can create a custom scale and add it to the collection.
SchedulerControl.SelectedInterval Gets the time interval currently selected in the scheduler's active view by an end-user.
TimelineView.SelectionBar Provides access to the selection bar options.
TimelineView.ShowResourceHeaders Gets or sets whether resource headers are displayed.
TimelineView.TimelineScrollBarVisible If a view is grouped by dates or resources, a vertical scrollbar appears, which enables an end-user to scroll a row to see hidden appointments.
SchedulerViewBase.GetVisibleIntervals Returns a copy of the visible time interval collection for the current view.
SchedulerViewBase.SetVisibleIntervals Fills the visible time interval collection with new items.
TimelineView.WorkTime Gets or sets the work time interval for a Timeline View.

The following table lists events that allow you to customize the View's layout.

Event Name



Fires when the SchedulerViewBase.GroupType is set to SchedulerGroupType.Date.

Allows you to manually paint the square area at the top left corner of the view.


Allows you to manually paint a Day of Week header.

SchedulerControl.CustomDrawGroupSeparator Allows you to paint a group separator in a custom manner.
SchedulerControl.CustomDrawNavigationButton Allows you to paint a navigation button in a custom manner.
SchedulerControl.CustomDrawResourceHeader Allows you to paint a resource header in a custom manner.
SchedulerControl.CustomDrawTimeCell Allows you to paint the time cells in a custom manner.

The following table lists services that allow you to customize the View's layout.



HeaderCaptionService Allows you to custom format the header captions.
HeaderToolTipService Allows you to specify custom tooltips for the day headers.

Expanded See Also

Is this topic helpful?​​​​​​​