Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [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]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Diagrams
  [Expand]Gauges
  [Expand]Map Control
  [Collapse]Scheduler
   [Expand]Product Information
   [Expand]Getting Started
   [Collapse]Fundamentals
    [Expand]Scheduler Elements
    [Expand]Scheduler Structure
    [Expand]Appointments
     Resources for Appointments
    [Collapse]Views
      Day View
      Work Week View
      Full Week View
      Week View
      Month View
      Timeline View
      Gantt View
      Agenda View
    [Expand]Data Binding
    [Expand]Mappings
    [Expand]Supported Formats
    [Expand]Services
    [Expand]Time Zones
     Printing
    [Expand]Scheduler Reporting
   [Expand]Visual Elements
   [Expand]Design-Time Features
   [Expand]Examples
   [Expand]End-User Capabilities
   [Expand]Member Tables
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]Printing-Exporting
  [Expand]PDF Viewer
   Reporting
  [Expand]Snap
  [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]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[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

Description

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.
Note

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

Description

SchedulerControl.CustomDrawWeekViewTopLeftCorner

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.

SchedulerControl.CustomDrawDayOfWeekHeader

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.

Service

Description

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

Expanded See Also

How would you rate this topic?​​​​​​​