PivotGridOptionsLayout.AddNewGroups Property

Gets or sets whether to retain field groups that exist in the current control layout, but do not exist in the layout being restored.

Namespace: DevExpress.XtraPivotGrid

Assembly: DevExpress.PivotGrid.v23.2.Core.dll

NuGet Packages: DevExpress.PivotGrid.Core, DevExpress.Win.Navigation

Declaration

C#

[DefaultValue(false)]
public bool AddNewGroups { get; set; }

VB.NET

<DefaultValue(False)>
Public Property AddNewGroups As Boolean

Property Value

Type	Default	Description
Boolean	false	true to retain field groups that exist in the current control layout, but do not exist in the layout being restored; false to destroy such field groups.

Property Paths

You can access this nested property as listed below:

Library	Object Type	Path to AddNewGroups
WinForms Controls	PivotGridControl	.OptionsLayout .AddNewGroups
Reporting	XRPivotGrid	.OptionsLayout .AddNewGroups

Remarks

The AddNewGroups property affects how the control layout is restored. If it is set to true, the field groups that exist in the current control layout, but do not exist in the layout being restored will be retained. Otherwise, these field groups will be destroyed.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the AddNewGroups 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#

pivot-grid-for-winforms-layout-upgrade/CS/WinPivotUpgradeLayout/Form1.cs#L20

pivotGridControlNew.OptionsLayout.Columns.RemoveOldColumns = false;
pivotGridControlNew.OptionsLayout.AddNewGroups = true;
pivotGridControlOld.OptionsLayout.LayoutVersion = "1.0";

VB.NET

pivot-grid-for-winforms-layout-upgrade/VB/WinPivotUpgradeLayout/Form1.vb#L23

pivotGridControlNew.OptionsLayout.Columns.RemoveOldColumns = False
pivotGridControlNew.OptionsLayout.AddNewGroups = True
pivotGridControlOld.OptionsLayout.LayoutVersion = "1.0"