Skip to main content

ColumnGroupInterval Enum

Lists the values that specify how the data rows are combined into groups when in grouping mode.

Namespace: DevExpress.XtraGrid

Assembly: DevExpress.Data.v14.2.dll

#Declaration

public enum ColumnGroupInterval

#Members

Name Description
Default

In regular binding mode, for columns which store date/time values, this option is the same as the ColumnGroupInterval.Date option. For non date/time columns this option is the same as the ColumnGroupInterval.Value option.

Value

Rows are grouped by their values (the entire values of each row in a group have to match). 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 it's own group).

Date

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

Column values are grouped by the date part. The time part of the values is ignored.

DateMonth

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

Column values are grouped by the month part. Examples of groups: January, February, March (the actual names of the months are determined by the current culture).

DateYear

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

Column values are grouped by the year part. Examples of such groups: 2003, 2004, 2005.

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

Combines column values into categories according to the character that the values start with.

DisplayText

Rows are grouped by cells' 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.

#Passed To

You can pass ColumnGroupInterval values to the GridColumn.GroupInterval property.

#Remarks

A column's GridColumn.GroupInterval property specifies how rows are combined into groups when data is grouped against this column. By default, the rows whose grouping column's values match are combined into the same groups.

To implement custom grouping, set the column's ColumnBase.SortMode property to ColumnSortMode.Custom and handle the GridControl.CustomColumnGroup event.

See Also