DayViewBase.TimeRulersSource Property
Gets or sets the source from which time rulers are generated. This is a dependency property.
Namespace: DevExpress.Xpf.Scheduling
Assembly: DevExpress.Xpf.Scheduling.v19.1.dll
Declaration
Property Value
Type | Description |
---|---|
IEnumerable | A collection that is used to generate time rulers. |
Remarks
Use the TimeRulersSource property to bind a scheduler view to a collection of objects containing time ruler settings, described in a Model or ViewModel. The SchedulerControl generates time rulers based on templates. A template that describes time rulers should be assigned to the view’s DayViewBase.TimeRulerTemplate property.
Example
The following example demonstrates how to add multiple time rulers to the scheduler’s Day View using the MVVM architectural pattern.
Use the DayViewBase.TimeRulersSource
property to bind the view to a collection of objects containing time ruler settings described in the ViewModel. The DayViewBase.TimeRulerTemplate property specifies a data template based on which time rulers are generated.
Create a custom style for the TimeRulerCellControl to specify format strings for displaying time in the time rulers’ time scale.
Note
A complete sample project is available at https://github.com/DevExpress-Examples/how-to-add-multiple-time-rulers-to-the-scheduler-and-adjust-their-settings-t587066.
<dx:ThemedWindow x:Class="WpfSchedulerTimeRulers.MainWindow" mc:Ignorable="d" Title="Time Rulers" Height="500" Width="800"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
xmlns:local="clr-namespace:WpfSchedulerTimeRulers"
xmlns:dx="http://schemas.devexpress.com/winfx/2008/xaml/core"
xmlns:dxmvvm="http://schemas.devexpress.com/winfx/2008/xaml/mvvm"
xmlns:dxsch="http://schemas.devexpress.com/winfx/2008/xaml/scheduling"
xmlns:dxschv="http://schemas.devexpress.com/winfx/2008/xaml/scheduling/visual"
DataContext="{dxmvvm:ViewModelSource local:MainViewModel}">
<dx:ThemedWindow.Resources>
<DataTemplate x:Key="TimeRulerGeneratorTemplate">
<ContentControl>
<dxsch:TimeRuler Caption="{Binding Caption}" ShowMinutes="{Binding ShowMinutes}" TimeZone="{Binding TimeZone}" AlwaysShowTimeDesignator="{Binding AlwaysShowTimeDesignator}"/>
</ContentControl>
</DataTemplate>
<Style TargetType="{x:Type dxschv:TimeRulerCellControl}">
<Setter Property="HourStringFormat" Value="{}{0:HH}"/>
<Setter Property="MinuteStringFormat" Value="{}{0:mm}"/>
</Style>
</dx:ThemedWindow.Resources>
<Grid>
<dxsch:SchedulerControl x:Name="scheduler">
<dxsch:DayView x:Name="dayView" ShowWorkTimeOnly="True" TimeScale="00:30:00" TimeRulersSource="{Binding TimeRulers}" TimeRulerTemplate="{StaticResource TimeRulerGeneratorTemplate}"/>
</dxsch:SchedulerControl>
</Grid>
</dx:ThemedWindow>
Related GitHub Examples
The following code snippet (auto-collected from DevExpress Examples) contains a reference to the TimeRulersSource 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.