Skip to main content

GridOptionsMenu.ShowAddNewSummaryItem Property

Gets or sets whether the footer menu displays an item that allows users to add multiple total summaries for a column.

Namespace: DevExpress.XtraGrid.Views.Grid

Assembly: DevExpress.XtraGrid.v23.2.dll

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

Declaration

[DefaultValue(DefaultBoolean.Default)]
[XtraSerializableProperty]
public virtual DefaultBoolean ShowAddNewSummaryItem { get; set; }

Property Value

Type Default Description
DefaultBoolean Default

A DefaultBoolean value that specifies the availability of the corresponding menu item.

Available values:

Name Description Return Value
True

The value is true.

0

False

The value is false.

1

Default

The value is specified by a global option or a higher-level object.

2

Property Paths

You can access this nested property as listed below:

Object Type Path to ShowAddNewSummaryItem
GridView
.OptionsMenu .ShowAddNewSummaryItem

Remarks

The ShowAddNewSummaryItem property allows you to show or hide the “Add New Summary” submenu item in the footer menu. The item lets an end-user add multiple summaries at runtime:

Add New Summary

By default, this property is set to DefaultBoolean.Default. This is equivalent to DefaultBoolean.True for GridView and BandedGridView Views, and to DefaultBoolean.False for AdvBandedGridView View.

To add multiple total summaries for a column in code, use the GridColumn.Summary property.

The “Add New Summary” submenu contains all available summaries, except those that have been applied to a column.

Example

The example demonstrates how to hide the “Add New Summary” item in the footer menu.

gridView1.OptionsMenu.ShowAddNewSummaryItem = DefaultBoolean.False;
See Also