SchedulerControl.GroupType Property

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

Namespace: DevExpress.XtraScheduler

Assembly: DevExpress.XtraScheduler.v19.1.dll

Declaration

C#

[DefaultValue(SchedulerGroupType.None)]
[XtraSerializableProperty(XtraSerializationFlags.DefaultValue)]
public SchedulerGroupType GroupType { get; set; }

VB.NET

<DefaultValue(SchedulerGroupType.None)>
<XtraSerializableProperty(XtraSerializationFlags.DefaultValue)>
Public Property GroupType As SchedulerGroupType

Property Value

Type	Default	Description
SchedulerGroupType	**None**	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

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 and the absence of 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 scheduler’s 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). But the manner in which each particular View is grouped can be changed via the View’s SchedulerViewBase.GroupType property that overrides the scheduler’s GroupType property.

Note

The GroupType property does not affect the Agenda View.

Example

The following example demonstrates how to group a scheduler’s data. To group data in a scheduler by dates or resources you should simply set the SchedulerControl.GroupType property to an appropriate value of the SchedulerGroupType type. The code below shows how this can be done.

C#

using DevExpress.XtraScheduler;
// ...

    // Disable data grouping.
    schedulerControl1.GroupType = SchedulerGroupType.None;

    // Group data by dates.
    schedulerControl1.GroupType = SchedulerGroupType.Date;

    // Group data by resources.
    schedulerControl1.GroupType = SchedulerGroupType.Resource;

VB.NET

Imports DevExpress.XtraScheduler
' ...

    ' Disable data grouping.
    SchedulerControl1.GroupType = SchedulerGroupType.None

    ' Group data by dates.
    SchedulerControl1.GroupType = SchedulerGroupType.Date

    ' Group data by resources.
    SchedulerControl1.GroupType = SchedulerGroupType.Resource

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references 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.

C#

winforms-schedulercontrol-api-t224044/CS/SchedulerAPISample/CodeExamples/AppointmentExamples.cs#L14

// Group by resource.
scheduler.GroupType = SchedulerGroupType.Resource;
// Create a new appointment.

how-to-use-the-appointment-split-tool-e340/CS/SplitAppointment/Form1.cs#L37

void barBtnGroupByNone_ItemClick(object sender, DevExpress.XtraBars.ItemClickEventArgs e) {
    schedulerControl.GroupType = SchedulerGroupType.None;
}

how-to-implement-drag-and-drop-appointment-functionality-between-two-schedulercontrols-t191007/CS/S173638/Form1.cs#L28

InitAppointments(schedulerStorage1);
schedulerControl1.GroupType = SchedulerGroupType.Resource;
schedulerControl2.GroupType = SchedulerGroupType.Resource;

printing-appointment-details-using-the-xtrareports-suite-e1183/CS/PrintingViaReports/Form1.cs#L162

    cbView.EditValue = schedulerControl1.ActiveViewType;
    rgrpGrouping.EditValue = schedulerControl1.GroupType;
}

scheduler-control-use-the-custom-draw-appointment-custom-draw-appointment-background-events/CS/CustomDrawDemo/Form1.cs#L101

    cbView.EditValue = schedulerControl1.ActiveViewType;
    rgrpGrouping.EditValue = schedulerControl1.GroupType;
}

VB.NET

winforms-schedulercontrol-api-t224044/VB/SchedulerAPISample/CodeExamples/AppointmentExamples.vb#L14

' Group by resource.
scheduler.GroupType = SchedulerGroupType.Resource
' Create a new appointment.

how-to-use-the-appointment-split-tool-e340/VB/SplitAppointment/Form1.vb#L38

Private Sub barBtnGroupByNone_ItemClick(ByVal sender As Object, ByVal e As DevExpress.XtraBars.ItemClickEventArgs)
    schedulerControl.GroupType = SchedulerGroupType.None
End Sub

how-to-implement-drag-and-drop-appointment-functionality-between-two-schedulercontrols-t191007/VB/S173638/Form1.vb#L27

InitAppointments(schedulerStorage1)
schedulerControl1.GroupType = SchedulerGroupType.Resource
schedulerControl2.GroupType = SchedulerGroupType.Resource

printing-appointment-details-using-the-xtrareports-suite-e1183/VB/PrintingViaReports/Form1.vb#L147

    cbView.EditValue = schedulerControl1.ActiveViewType
    rgrpGrouping.EditValue = schedulerControl1.GroupType
End Sub

scheduler-control-use-the-custom-draw-appointment-custom-draw-appointment-background-events/VB/CustomDrawDemo/Form1.vb#L100

    cbView.EditValue = schedulerControl1.ActiveViewType
    rgrpGrouping.EditValue = schedulerControl1.GroupType
End Sub