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.v20.1.dll

Declaration

[DefaultValue(DefaultBoolean.Default)]
[XtraSerializableProperty]
public virtual DefaultBoolean ShowAddNewSummaryItem { get; set; }
<DefaultValue(DefaultBoolean.Default)>
<XtraSerializableProperty>
Public Overridable Property ShowAddNewSummaryItem As DefaultBoolean

Property Value

Type Default Description
DefaultBoolean

Default

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

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.

Examples

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

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