GridOptionsMenu.ShowAddNewSummaryItem Property

Gets or sets whether or not the footer menu contains an item that allows adding multiple total summaries for a column at runtime.

Namespace: DevExpress.XtraGrid.Views.Grid

Assembly: DevExpress.XtraGrid.v21.2.dll

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
True

Corresponds to a Boolean value of true.

False

Corresponds to a Boolean value of false.

Default

The default behavior determined by the control’s logic.

Property Paths

You can access this nested property as listed below:

Object Type Path to ShowAddNewSummaryItem
AdvBandedGridView
.OptionsMenu.ShowAddNewSummaryItem
BandedGridView
.OptionsMenu.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