Skip to main content

SchedulerControl.GroupType Property

Gets or sets a value that specifies the type of grouping applied to the View of the Scheduler control.

Namespace: DevExpress.Xpf.Scheduler

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

NuGet Package: DevExpress.Wpf.Scheduler

Declaration

public SchedulerGroupType GroupType { get; set; }

Property Value

Type Description
SchedulerGroupType

A SchedulerGroupType enumeration value that specifies how appointments are grouped within the Scheduler control.

Available values:

Name Description
None

No grouping is applied.

Date

Grouping by dates. Appointments are grouped by dates.

Resource

Grouping by resources. Appointments are grouped by resources.

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.

If the appointments which are managed by the Scheduler control belong to more than one resource, then the GroupType property can be used to group the appointments within the scheduling area. The available types of grouping are specified by the SchedulerGroupType enumeration, and include grouping by dates, grouping by resources or no grouping. Grouping appointments by dates or resources facilitates the task of managing user time within the scheduling area.

Note that grouping can also be applied at the level of each particular View via its SchedulerViewBase.GroupType property. When setting the GroupType property, its value is assigned to each View’s SchedulerViewBase.GroupType property, so that the same grouping will be applied within the scheduling area, regardless of the type of the scheduler’s active View (SchedulerControl.ActiveView). The manner in which each particular View is grouped can be changed via the View’s SchedulerViewBase.GroupType property, which overrides the GroupType property.

Note

Do not use the SchedulerViewBase.GroupType property in the XAML markup. Instead, use it in the code-behind file after calling the InitializeComponent method.

Example

This example demonstrates how to group the Scheduler control’s data by resources via the SchedulerControl.GroupType property. You can selectively do this, either at design time (via the XAML markup)…

<dxsch:SchedulerControl Name="schedulerControl1" 
                        GroupType="Resource"/>

…or at runtime (via code in the code-behind file).

using DevExpress.XtraScheduler;
// ...

schedulerControl1.GroupType = SchedulerGroupType.Resource;

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

See Also