Skip to main content

GridColumn.GroupInterval Property

Gets or sets how data rows are grouped when grouping by the current column is applied. This is a bindable property.

Namespace: DevExpress.Mobile.DataGrid

Assembly: DevExpress.Mobile.Grid.v18.2.dll

Declaration

[XtraSerializableProperty]
public ColumnGroupInterval GroupInterval { get; set; }

Property Value

Type Description
ColumnGroupInterval

A ColumnGroupInterval enumeration value that specifies how data rows are grouped.

Available values:

Name Description
Default

For columns which store date/time values, this option is the same as the ColumnGroupInterval.DateRange option. For non date/time columns, this option is the same as the ColumnGroupInterval.Value option.

Value

Rows are grouped by their values. The number of groups matches the number of unique values within the grouping column.

Note that DateTime objects which have the same date portion but different time portions are treated as unique values (each has its own group).

Date

This option is in effect only for columns that store date/time values.

Rows are grouped by the date part of their values. The time portion is ignored in this grouping mode.

DateMonth

This option is in effect only for columns that store date/time values.

Rows are grouped by the month and year. Examples of such groups: “January, 2014” , “February, 2014”, “March, 2015”…

DateQuarter

This option is in effect only for columns that store date/time values.

Rows are grouped by the quarter and year. Examples of groups: “Q3, 2014”, “Q4, 2014”, “Q1, 2015” …

DateYear

This option is in effect only for columns that store date/time values.

Rows are grouped by the year. Examples of such groups: “2013”, “2014”, “2016”…

DateRange

This option is in effect only for columns that store date/time values.

Rows are grouped into the following groups according to their date value as compared with the current system date: “Today”, “Tomorrow”, “Sunday”, “Monday”, “Tuesday”, “Wednesday”, “Thursday”, “Friday”, “Saturday”, “Next Week”, “Two Weeks Away”, “Three Weeks Away”, “Next Month”, “Beyond Next Month”, “Yesterday”, “Last Week”, “Two Weeks Ago”, “Three Weeks Ago”, “Last Month”, “Older”.

Alphabetical

Rows are grouped by the first character of their value.

DisplayText

Rows are grouped by the cell’s display values.

In specific instances, cells can have different edit values, but the same display value. To combine these rows into the same group, use the DisplayText group mode.

Remarks

Important

This documentation topic describes legacy technology. We no longer develop new functionality for the GridControl and suggest that you use the new DataGridView control instead.

When data is grouped by a specific column, data rows are combined into groups. By default, each group contains rows which have the same value in the field (column) for which grouping has been applied. Use the GroupInterval property to change the logic used to decide which rows should be grouped together. For instance, for a column that displays date/time information, you can set its GroupInterval property to ColumnGroupInterval.DateRange. In this case, when grouping is applied against this column, the data rows will be combined into groups according to their date value compared with the current system date (“Today”, “Yesterday”, etc.).

Grid_GoupInterval

See Also