SchedulerControl.Start Property

Gets or sets the SchedulerControl start date. This is a dependency property.

Namespace: DevExpress.Xpf.Scheduling

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

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

Declaration

C#

public DateTime Start { get; set; }

VB.NET

Public Property Start As Date

Property Value

Type	Description
DateTime	A DateTime value which represents the start date of the SchedulerControl.

Remarks

The Scheduler control’s start date is the date on which the scheduler initially shows its data, according to its SchedulerControl.ActiveViewIndex.

The Start value is used to calculate the time interval displayed in the view. However, the start of the visible time interval may be different, because each view can have its display restrictions.

Consider an application that uses the DateNavigator control bound to the scheduler (the SchedulerDateNavigatorStyleSettings.Scheduler property is set to the SchedulerControl). When the end user clicks the date in the DateNavigator, it sets the SchedulerControl’s Start property to that date. If you switch to the Work Week View and click a date that is Saturday in the DateNavigator, the Start property is set to the Saturday. However, the view is unable to display that date because Saturday is not a working day. So the visible interval is Monday to Friday.

Tip

The SchedulerControl.Start property is used as a base for calculating visible intervals when rendering a view, but the actual intervals displayed in the view are available using the SchedulerControl.VisibleIntervals property.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Start 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-color-time-cells-partially-t590114/CS/SchedulerCellTemplate/MainWindow.xaml#L26

</dxlc:LayoutControl>
<dxsch:SchedulerControl x:Name="scheduler" GroupType="Resource" Start="{Binding Start, Mode=TwoWay}" AllowAppointmentConflicts="True">
    <dxsch:DayView

how-to-customize-time-scales-in-the-timeline-view-t591091/CS/WpfSchedulerTimelineScalesTemplate/MainWindow.xaml#L39

<Grid>
    <dxsch:SchedulerControl x:Name="scheduler" GroupType="None" Start="{Binding Start, Mode=TwoWay}" AllowAppointmentConflicts="True">
        <dxsch:TimelineView x:Name="timelineView" IntervalCount="8" TimeScalesSource="{Binding TimeScales}" TimeScaleTemplateSelector="{StaticResource TimeScaleTemplateSelector}"/>

how-to-hide-non-working-days-in-the-day-view-using-custom-commands-and-key-handlers-t608137/CS/NavigateCommandExample/MainWindow.xaml#L28

CommandBarStyle="Ribbon"
Start="{Binding SchedulerStart, Mode=OneTime}"
VisibleIntervalsChanged="{DXEvent Handler='OnVisibleIntervalsChanged(@sender, @args)'}">

C#

how-to-hide-non-working-days-in-the-day-view-using-custom-commands-and-key-handlers-t608137/CS/NavigateCommandExample/ViewModel/MainViewModel.cs#L74

    FixVisibleDays(forward, scheduler);
    SchedulerStart = scheduler.Start;
}

VB.NET

how-to-hide-non-working-days-in-the-day-view-using-custom-commands-and-key-handlers-t608137/VB/NavigateCommandExample/ViewModel/MainViewModel.vb#L67

    FixVisibleDays(forward, scheduler)
    SchedulerStart = scheduler.Start
End Sub