Skip to main content

GroupSummarySortInfo Class

Represents an element in a GroupSummarySortInfoCollection.

Namespace: DevExpress.XtraGrid.Columns

Assembly: DevExpress.XtraGrid.v24.1.dll

NuGet Packages: DevExpress.Win.Grid, DevExpress.Win.Navigation

Declaration

public class GroupSummarySortInfo

Remarks

Group rows can be sorted by summary values. To do this create GroupSummarySortInfo objects and add them to the GridView.GroupSummarySortInfo collection via the GroupSummarySortInfoCollection.Add method.

The GroupSummarySortInfo objects contain the information required to sort group rows by summary values. This includes the nesting level of the group rows that are to be sorted by the summary values and the sort order and summary item which is used to calculate summary values for groups of rows.

To cancel any sorting of the group rows by summary values, remove the corresponding GroupSummarySortInfo object from the collection. Note that the GroupSummarySortInfo objects are automatically removed from the collection after the sort order of the group columns they correspond to has been changed.

For more information on sorting group rows by summary values, see the Working with Summaries in Code. Custom Summaries document.

Example

The following example shows how to sort the group rows that reside at the first grouping level by summary values. The group summaries are calculated by the Freight column’s values.

The image below shows the result.

SummarySortInfo

using DevExpress.Data;
using DevExpress.XtraGrid;
using DevExpress.XtraGrid.Columns;

GridSummaryItem summaryItemMaxFreight;
private void Form1_Load(object sender, System.EventArgs e) {
   // ...
   //  Creating a new summary item and adding it the view's summary item collection.
   summaryItemMaxFreight = gridView1.GroupSummary.Add(SummaryItemType.Max, 
     "Freight", null, String.Empty);
}

private void button1_Click(object sender, System.EventArgs e) {
   GridColumn summaryColumn = gridView1.Columns["Freight"];
   if(summaryColumn.GroupIndex < 0 && gridView1.GroupCount > 0) {
      GridColumn firstGroupingColumn = gridView1.SortInfo[0].Column;
      gridView1.GroupSummarySortInfo.Add(summaryItemMaxFreight, 
        ColumnSortOrder.Ascending, firstGroupingColumn);
   }
}

Inheritance

Object
GroupSummarySortInfo
See Also