SchedulerControl.ActiveViewType Property

Gets or sets the type of the View which is currently used by the SchedulerControl to show its data.

Namespace: DevExpress.Xpf.Scheduler

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

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

Declaration

C#

[DefaultValue(SchedulerViewType.Day)]
public SchedulerViewType ActiveViewType { get; set; }

VB.NET

<DefaultValue(SchedulerViewType.Day)>
Public Property ActiveViewType As SchedulerViewType

Property Value

Type	Default	Description
SchedulerViewType	**Day**	A SchedulerViewType enumeration value specifying the active View type.

Available values:

Name	Description
Day	Specifies the DayView. This view lets end-users schedule and view appointments by day.
Week	Specifies the WeekView. This view lets end-users schedule and view appointments by week in a compact form.
Month	Specifies the MonthView. This view lets end-users schedule and view appointments across several weeks.
WorkWeek	Specifies the WorkWeekView. This view displays appointments for the working days in a particular week.
Timeline	Specifies the TimelineView. This view displays appointments as horizontal bars along the timescales, and provides end-users with a clearer overview for scheduling purposes.
Gantt	Specifies the GanttView. This view lets end-users schedule and view appointments as tasks with dependencies and show information on task completion status.
FullWeek	Specifies the FullWeekView. This view allows end-users to schedule and view appointments by the entire week.
Agenda	Specifies the AgendaView. This view allows end-users to list appointments by day.
Year	Specifies the YearView. This view displays appointments for the entire year.

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.

To access the current View of the scheduler, use the SchedulerControl.ActiveView property.

Example

This example demonstrates how to provide end-users with the capability to change the type of View that is currently active in the Scheduler control.

The code below illustrates how to use the RadioButtonList control for this. This control should be bound to a ArrayList object, which contains items equivalent to the SchedulerViewType enumeration values. Then, it is necessary to bind the RadioButtonList.SelectedValue property value to the SchedulerControl.ActiveViewType property of the Scheduler control.

View Example

MainWindow.xaml

<GroupBox Header="View Types" Grid.Column="0">
    <dx:RadioButtonList x:Name="viewType" Margin="4" 
        HorizontalAlignment="Stretch" VerticalAlignment="Stretch"
        Background="{x:Null}" 
        SelectedValue="{Binding ElementName=schedulerControl1, Path=ActiveViewType, Mode=TwoWay}">
        <dx:RadioButtonList.ItemsSource>
            <collections:ArrayList>
                <dxschcore:SchedulerViewType>Day</dxschcore:SchedulerViewType>
                    <dxschcore:SchedulerViewType>FullWeek</dxschcore:SchedulerViewType>
                    <dxschcore:SchedulerViewType>Week</dxschcore:SchedulerViewType>
                <dxschcore:SchedulerViewType>WorkWeek</dxschcore:SchedulerViewType>
                <dxschcore:SchedulerViewType>Month</dxschcore:SchedulerViewType>
                <dxschcore:SchedulerViewType>Timeline</dxschcore:SchedulerViewType>
            </collections:ArrayList>
        </dx:RadioButtonList.ItemsSource>
    </dx:RadioButtonList>
</GroupBox>

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the ActiveViewType 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#L21

Background="{x:Null}"
SelectedValue="{Binding ElementName=schedulerControl1, Path=ActiveViewType, Mode=TwoWay}">
<dx:RadioButtonList.ItemsSource>

how-to-display-custom-field-values-in-resource-headers-e3044/CS/MainWindow.xaml#L50

<Grid>
    <dxsch:SchedulerControl Name="schedulerControl1" GroupType="Resource" ActiveViewType="Timeline">
        <dxsch:SchedulerControl.Storage>

how-to-create-a-custom-appointment-recurrence-form-e3797/CS/WpfApplication1/MainWindow.xaml#L10

HorizontalAlignment="Stretch" VerticalAlignment="Stretch"
ActiveViewType="Week"
GroupType="Resource"

how-to-remove-highlighting-of-the-current-day-header-and-alternate-cell-color-e4747/CS/MainWindow.xaml#L156

<Grid>
    <dxsch:SchedulerControl Name="schedulerControl1" ActiveViewType="WorkWeek" />
</Grid>

how-to-customize-the-rangecontrol-auto-adjustment-behavior-e5122/CS/SchedulerRangeControlExample/MainWindow.xaml#L17

</dxe:RangeControl>
<dxsch:SchedulerControl x:Name="scheduler" Grid.Row="2" VerticalAlignment="Stretch" ActiveViewType="WorkWeek" RangeControlAutoAdjusting="schedulerControl1_RangeControlAutoAdjusting" >
</dxsch:SchedulerControl>

C#

how-to-display-appointments-in-agenda-view-by-using-the-dxgrid-for-wpf-component-t239055/CS/Views/AgendaView.xaml.cs#L115

private void OnDayViewItemClick(object sender, DevExpress.Xpf.Bars.ItemClickEventArgs e) {
    OwnerScheduler.ActiveViewType = SchedulerViewType.Day;
    SwitchToMainvView();

how-to-synchronize-gridcontrol-selection-and-filters-with-schedulercontrol-t328445/CS/SchedulerViewModel.cs#L57

Scheduler.ActiveView.GotoTimeInterval(new TimeInterval(CurrentModelAppointment.StartTime, CurrentModelAppointment.EndTime));
if (Scheduler.ActiveViewType == SchedulerViewType.Day)
    (Scheduler.ActiveView as DayView).TopRowTime = CurrentModelAppointment.StartTime.TimeOfDay;

VB.NET

how-to-display-appointments-in-agenda-view-by-using-the-dxgrid-for-wpf-component-t239055/VB/Views/AgendaView.xaml.vb#L124

Private Sub OnDayViewItemClick(ByVal sender As Object, ByVal e As DevExpress.Xpf.Bars.ItemClickEventArgs)
    OwnerScheduler.ActiveViewType = SchedulerViewType.Day
    SwitchToMainvView()

how-to-synchronize-gridcontrol-selection-and-filters-with-schedulercontrol-t328445/VB/SchedulerViewModel.vb#L81

Scheduler.ActiveView.GotoTimeInterval(New TimeInterval(CurrentModelAppointment.StartTime, CurrentModelAppointment.EndTime))
If Scheduler.ActiveViewType = SchedulerViewType.Day Then
    TryCast(Scheduler.ActiveView, DayView).TopRowTime = CurrentModelAppointment.StartTime.TimeOfDay