DayView.TimeScale Property

Gets or sets the time interval for the time slots in the scheduling area.

Namespace: DevExpress.Xpf.Scheduler

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

Declaration

C#

public TimeSpan TimeScale { get; set; }

VB.NET

Public Property TimeScale As TimeSpan

Property Value

Type	Description
TimeSpan	A TimeSpan value representing the time interval for the time slots.

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 TimeScale property to specify the time interval, which is the amount by which the time scale displayed in the scheduling area increments. This property’s value applies to the time rulers in the scheduling area. When a new value is set for the TimeScale property, the division of hours is changed in the time ruler to reflect the specified increment.

Note

Note that the TimeScale property cannot be set to any arbitrary value. When assigning a value to the TimeScale property, it is automatically calculated to equal the nearest TimeSlot.Value set for one of the time slots contained within the DayView.TimeSlots collection.

Example

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

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

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-customize-scheduler-views-e2526.

MainWindow.xaml

<dxsch:SchedulerControl.DayView>
    <dxsch:DayView DayCount="3" 
                   ShowAllDayArea="True" AllDayAreaScrollBarVisible="False" 
                   ShowDayHeaders="True"
                   TimeScale="00:30:00"
                   ShowWorkTimeOnly="False" 
                   ShowMoreButtons="True" ShowMoreButtonsOnEachColumn="True">
        <dxsch:DayView.AppointmentDisplayOptions>
            <dxsch:SchedulerDayViewAppointmentDisplayOptions ShowRecurrence="True" 
                   ShowReminder="True" 
                   TimeDisplayType="Text" 
                   StatusDisplayType="Time"
                   StartTimeVisibility="Always" 
                   EndTimeVisibility="Always" />
        </dxsch:DayView.AppointmentDisplayOptions>
        <dxsch:DayView.WorkTime>
            <dxschcore:TimeOfDayInterval Start="09:30:00" End="18:30:00" />
        </dxsch:DayView.WorkTime>
        <dxsch:DayView.VisibleTime>
            <dxschcore:TimeOfDayInterval Start="08:00:00" End="20:00:00" />
        </dxsch:DayView.VisibleTime>
    </dxsch:DayView>
</dxsch:SchedulerControl.DayView>

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the TimeScale 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.

C#

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

ShowDayHeaders="True"
TimeScale="00:30:00"
ShowWorkTimeOnly="False"