GridViewBase.AllowGrouping Property

Gets or sets a value that specifies whether an end-user can group data. This is a dependency property.

Namespace: DevExpress.Xpf.Grid

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

Declaration

C#

public bool AllowGrouping { get; set; }

VB.NET

Public Property AllowGrouping As Boolean

Property Value

Type	Description
Boolean	true to allow an end-user to group data; otherwise, false.

Remarks

End-users can group data in two ways:

• Drag a column’s header to the group panel (requires the GridViewBase.ShowGroupPanel property to be set to true).
• Invoke a column’s context menu by right-clicking its header, and select the Group By This Column menu item.

Both methods are allowed if the view’s AllowGrouping property is set to true.

Individual columns provide the GridColumn.AllowGrouping property, allowing the default behavior specified by the view, to be overridden. To learn more, see Grouping Overview.

Note

Data grouping requires data sorting to be performed. End-users can group data only if data sorting is allowed.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the AllowGrouping 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-emulate-binding-to-the-isexpanded-property-of-the-treelistnode-t127638/CS/DevExpress.Example04/MainWindow.xaml#L43

<dxg:GridControl.View>
    <dxg:TableView CellValueChanging="TableView_CellValueChanging" AllowGrouping="False"/>
</dxg:GridControl.View>

how-to-drag-columns-to-gridcontrol-from-an-external-source-e4175/CS/DragDropColumns/MainWindow.xaml#L44

<dxg:GridControl.View>
    <my:MyTableView x:Name="tableView1" ShowTotalSummary="True" AllowGrouping="True"/>
</dxg:GridControl.View>

how-to-group-gridcontrol-by-multiple-values-the-multi-value-grouping-demo-v162-and-lower-t513354/CS/DXApplication3/MainWindow.xaml#L45

<dxg:GridControl.View>
    <dxg:TableView Name="view" ShowGroupedColumns="True" AllowGrouping="False">
    </dxg:TableView>

how-to-customize-the-merge-field-collection-and-perform-mail-merge-using-the-ilist-data-so-t532297/CS/SimpleDataMerge/CustomizeMergeFieldsControl.xaml#L26

<dxg:GridControl.View>
    <dxg:TableView IsColumnMenuEnabled="False" AutoWidth="True" AllowFilterEditor="False" ShowIndicator="False" AllowHorizontalScrollingVirtualization="True" AllowGrouping="False" AllowEditing="True" ShowGroupPanel="False" />
</dxg:GridControl.View>

how-to-implement-custom-collection-that-loads-data-asynchronously-e4729/CS/AsyncDataLoading/Core/AsynchronousDataLoadingBehavior.cs#L138

    if(!IsGridEnabled || GridView == null) return;
    if(GridView is TableView) ((TableView)GridView).AllowGrouping = AllowGrouping;
}

VB.NET

how-to-implement-custom-collection-that-loads-data-asynchronously-e4729/VB/AsyncDataLoading/Core/AsynchronousDataLoadingBehavior.vb#L180

If TypeOf GridView Is TableView Then
    CType(GridView, TableView).AllowGrouping = AllowGrouping
End If