ColumnView.GroupCount Property

Gets or sets how many columns are used to group data.

Namespace: DevExpress.XtraGrid.Views.Base

Assembly: DevExpress.XtraGrid.v19.2.dll

Declaration

C#

[Browsable(false)]
[DefaultValue(0)]
public int GroupCount { get; set; }

VB.NET

<Browsable(False)>
<DefaultValue(0)>
Public Property GroupCount As Integer

Property Value

Type	Default	Description
Int32	0	The number of columns used to group data.

Remarks

The GroupCount property is synchronized with the GridColumnSortInfoCollection.GroupCount property of the View’s ColumnView.SortInfo collection.

The View’s ColumnView.SortInfo property represents a collection of sorted columns. When grouping is applied, data is always sorted by the grouping columns first. So, the grouping columns always come first in the ColumnView.SortInfo collection. The GridColumnSortInfoCollection.GroupCount property (and therefore the current GroupCount property) specifies the number of elements starting from the beginning of the collection that refer to the columns used to group data. Set this property to 0 or a negative value to remove all the grouping, data will only be sorted by the columns in the collection.

Set this property to 1 to apply grouping by the first column and remove grouping by the subsequent columns. Setting the GroupCount property to a value greater than or equal to the number of elements in the collection will apply grouping to all the columns in the collection.

Card Views do not support data grouping. So changing the GroupCount property has no effect for Card Views.

Related GitHub Examples

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

how-to-specify-visibility-of-rows-in-gridview-during-printing-export-e3174/CS/ExportToXlsx/ExportHelper.cs#L109

focusedRow = view.FocusedRowHandle;
if (view.GroupCount > 0)
{

how-to-determine-whether-all-rows-are-expanded-or-collapsed-e2248/CS/IsFullExpandedOrCollapsed/Form1.cs#L26

bool IsFullExpanded(GridView view) {
    if(view.GroupCount == 0) return true;
    if(view.DataRowCount == 0) return true;

how-to-display-a-limited-number-of-child-rows-in-an-expanded-group-in-gridview-t495343/CS/DXApplication3/GroupHelper.cs#L38

var info = e.Info as GridGroupRowInfo;
if (!info.IsGroupRowExpanded || info.Level != view.GroupCount - 1 || !groupRows.ContainsKey(e.RowHandle))
    return;

reporting-winforms-convert-grid-to-report/CS/XtraReport1.cs#L23

this.DataMember = gridData.Tables[0].TableName;
for(int i = gv.GroupCount-1; i >= 0; i--)
    InsertGroupBand(gv.GroupedColumns[i],i);

how-to-create-a-report-based-on-bandedgridview-at-runtime-t192075/CS/XtraReport1.cs#L23

this.DataMember = gridData.Tables[0].TableName;
for(int i = gv.GroupCount-1; i >= 0; i--)
    InsertGroupBand(gv.GroupedColumns[i],i);

VB.NET

how-to-specify-visibility-of-rows-in-gridview-during-printing-export-e3174/VB/ExportToXlsx/ExportHelper.vb#L107

focusedRow = view.FocusedRowHandle
If view.GroupCount > 0 Then
    LayoutStream = New MemoryStream()

how-to-determine-whether-all-rows-are-expanded-or-collapsed-e2248/VB/IsFullExpandedOrCollapsed/Form1.vb#L28

Private Function IsFullExpanded(ByVal view As GridView) As Boolean
    If view.GroupCount = 0 Then
        Return True

how-to-display-a-limited-number-of-child-rows-in-an-expanded-group-in-gridview-t495343/VB/DXApplication3/GroupHelper.vb#L35

Dim info = TryCast(e.Info, GridGroupRowInfo)
If (Not info.IsGroupRowExpanded) OrElse info.Level <> view.GroupCount - 1 OrElse (Not groupRows.ContainsKey(e.RowHandle)) Then
    Return

reporting-winforms-convert-grid-to-report/VB/XtraReport1.vb#L24

DataMember = gridData.Tables(0).TableName
For i As Integer = gv.GroupCount - 1 To 0 Step -1
    InsertGroupBand(gv.GroupedColumns(i), i)

how-to-create-a-report-based-on-bandedgridview-at-runtime-t192075/VB/XtraReport1.vb#L24

Me.DataMember = gridData.Tables(0).TableName
For i As Integer = gv.GroupCount-1 To 0 Step -1
    InsertGroupBand(gv.GroupedColumns(i),i)