TabbedLayoutGroupTabPageSettings.EnableHierarchyRecreation Property

Gets or sets a value that specifies whether the tabbed layout group enables its control hierarchy to be forcibly recreated, to apply the settings defined at runtime to its child controls.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v19.2.dll

Declaration

C#

[DefaultValue(true)]
public bool EnableHierarchyRecreation { get; set; }

VB.NET

<DefaultValue(True)>
Public Property EnableHierarchyRecreation As Boolean

Property Value

Type	Default	Description
Boolean	**true**	true, if the control’s hierarchy recreation is enabled; otherwise, false.

Property Paths

You can access this nested property as listed below:

Show 14 property paths

Library	Object Type	Path to EnableHierarchyRecreation
ASP.NET Controls and MVC Extensions	CardViewTabbedLayoutGroup	.SettingsTabPages.EnableHierarchyRecreation
	GridTabbedLayoutGroup	.SettingsTabPages.EnableHierarchyRecreation
	GridViewTabbedLayoutGroup	.SettingsTabPages.EnableHierarchyRecreation
	MVCxCardViewTabbedLayoutGroup	.SettingsTabPages.EnableHierarchyRecreation
	MVCxGridViewTabbedLayoutGroup	.SettingsTabPages.EnableHierarchyRecreation
	MVCxGridViewTabbedLayoutGroup<ModelType>	.SettingsTabPages.EnableHierarchyRecreation
	MVCxTabbedFormLayoutGroup	.SettingsTabPages.EnableHierarchyRecreation
	MVCxTabbedFormLayoutGroup<ModelType>	.SettingsTabPages.EnableHierarchyRecreation
	TabbedLayoutGroup	.SettingsTabPages.EnableHierarchyRecreation
ASP.NET Bootstrap Controls	BootstrapCardViewTabbedLayoutGroup	.SettingsTabPages.EnableHierarchyRecreation
	BootstrapDialogTabbedFieldGroup	.SettingsTabPages.EnableHierarchyRecreation
	BootstrapDialogTabbedFieldGroup<TViewModel>	.SettingsTabPages.EnableHierarchyRecreation
	BootstrapGridViewTabbedLayoutGroup	.SettingsTabPages.EnableHierarchyRecreation
	BootstrapTabbedLayoutGroup	.SettingsTabPages.EnableHierarchyRecreation

Remarks

When you modify the tabbed layout group’s properties programmatically at runtime, the ViewState is utilized to remember the state change. Across a postback, the control hierarchy is recreated. After that, the page’s view state is applied.

If the control settings are modified, changing the child controls hierarchy (e.g., toggling a tab page’s TabBase.Visible property via code), must be recreated again after the ViewState is loaded; otherwise, the control may function improperly.

Set the EnableHierarchyRecreation property to true to forcibly recreate the control hierarchy after the ViewState is loaded (after a postback).

Note

Set the EnableHierarchyRecreation property in a markup or at runtime in the page’s Init event (before the ViewState is loaded).