Skip to main content

TimelineView.Scales Property

Provides access to a collection of time scales displayed in the Timeline View.

Namespace: DevExpress.Xpf.Scheduler

Assembly: DevExpress.Xpf.Scheduler.v24.1.dll

NuGet Package: DevExpress.Wpf.Scheduler

Declaration

public TimeScaleCollection Scales { get; set; }

Property Value

Type Description
TimeScaleCollection

A TimeScaleCollection object containing time scales for the Timeline View.

Remarks

Important

You are viewing documentation for the legacy WPF Scheduler control. If you’re starting a new project, we strongly recommend that you use a new control declared in the DevExpress.Xpf.Scheduling namespace. If you decide to upgrade an existing project in order to switch to the updated scheduler control, see the Migration Guidelines document.

Use the Scales property to access the time scale collection, and specify the TimeScale elements of the current view. The available time scales are used in the visible time interval calculations, and you may control whether a particular time scale should be considered via the TimeScale.Enabled property. The display options can be customized via the TimeScale.DisplayFormat and TimeScale.Width properties. You may hide a specific time scale by setting the TimeScale.Visible property
to false.

The most detailed time scale that is enabled, and displayed visually as a basis for the scales, is returned by the TimelineView.GetBaseTimeScale method.

Example

This example demonstrates how to customize the Timeline View within the Scheduler control.

To do this, it is necessary to modify the TimelineView object accessed via the SchedulerControl.TimelineView property.

<dxsch:SchedulerControl.TimelineView>
    <dxsch:TimelineView IntervalCount="12" 
                    TimelineScrollBarVisible="False">
        <dxsch:TimelineView.Scales>
            <dxschcore:TimeScaleCollection>
                <dxschcore:TimeScaleMonth />
                <dxschcore:TimeScaleWeek />
                <dxschcore:TimeScaleDay DisplayFormat="ddd dd" />
                <local:CustomTimeScale />
            </dxschcore:TimeScaleCollection>
        </dxsch:TimelineView.Scales>
        <dxsch:TimelineView.AppointmentDisplayOptions>
            <dxsch:SchedulerTimelineViewAppointmentDisplayOptions ShowRecurrence="False"
                    ShowReminder="False" 
                    StartTimeVisibility="Auto"  
                    EndTimeVisibility="Auto" />
        </dxsch:TimelineView.AppointmentDisplayOptions>
    </dxsch:TimelineView>
</dxsch:SchedulerControl.TimelineView>
See Also