TimelineView.Scales Property

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

Namespace: DevExpress.Xpf.Scheduler

Assembly: DevExpress.Xpf.Scheduler.v20.2.dll

NuGet Packages: DevExpress.WindowsDesktop.Wpf.Scheduler, DevExpress.Wpf.Scheduler

Declaration

C#

public TimeScaleCollection Scales { get; set; }

VB.NET

Public Property Scales As TimeScaleCollection

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.

View Example

MainWindow.xaml

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

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Scales property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

XAML

how-to-customize-scheduler-views-e2526/CS/WpfApplication1/MainWindow.xaml#L134

            TimelineScrollBarVisible="False">
<dxsch:TimelineView.Scales>
    <dxschcore:TimeScaleCollection>

how-to-associate-a-specific-color-schema-with-a-particular-resource-e3208/CS/WpfApplication1/MainWindow.xaml#L50

<dxsch:TimelineView ResourcesPerPage="4" IntervalCount="7">
    <dxsch:TimelineView.Scales>
        <dxschcore:TimeScaleCollection>