Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Collapse]WPF Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Expand]Controls and Libraries
 [Expand]Scaffolding Wizard
 [Expand]Localization
  Redistribution and Deployment
  Get More Help
 [Collapse]API Reference
  [Expand]DevExpress.Charts.Designer
  [Expand]DevExpress.Mvvm.UI
  [Expand]DevExpress.Mvvm.UI.Interactivity
  [Expand]DevExpress.Mvvm.UI.ModuleInjection
  [Expand]DevExpress.Xpf.Accordion
  [Expand]DevExpress.Xpf.Bars
  [Expand]DevExpress.Xpf.Carousel
  [Expand]DevExpress.Xpf.Charts
  [Expand]DevExpress.Xpf.Charts.Localization
  [Expand]DevExpress.Xpf.Charts.RangeControlClient
  [Expand]DevExpress.Xpf.ChunkList
  [Expand]DevExpress.Xpf.Controls
  [Expand]DevExpress.Xpf.Core
  [Expand]DevExpress.Xpf.Core.ConditionalFormatting
  [Expand]DevExpress.Xpf.Core.DataSources
  [Expand]DevExpress.Xpf.Core.ServerMode
  [Expand]DevExpress.Xpf.Data
  [Expand]DevExpress.Xpf.DataAccess
  [Expand]DevExpress.Xpf.DataAccess.DataSourceWizard
  [Expand]DevExpress.Xpf.Diagram
  [Expand]DevExpress.Xpf.Docking
  [Expand]DevExpress.Xpf.Docking.Base
  [Expand]DevExpress.Xpf.DocumentViewer
  [Expand]DevExpress.Xpf.DXBinding
  [Expand]DevExpress.Xpf.Editors
  [Expand]DevExpress.Xpf.Editors.DateNavigator
  [Expand]DevExpress.Xpf.Editors.ExpressionEditor
  [Expand]DevExpress.Xpf.Editors.ExpressionEditor.Native
  [Expand]DevExpress.Xpf.Editors.Filtering
  [Expand]DevExpress.Xpf.Editors.Flyout
  [Expand]DevExpress.Xpf.Editors.Flyout.Native
  [Expand]DevExpress.Xpf.Editors.Helpers
  [Expand]DevExpress.Xpf.Editors.Popups
  [Expand]DevExpress.Xpf.Editors.RangeControl
  [Expand]DevExpress.Xpf.Editors.Settings
  [Expand]DevExpress.Xpf.Editors.Validation
  [Expand]DevExpress.Xpf.ExpressionEditor
  [Expand]DevExpress.Xpf.Gauges
  [Expand]DevExpress.Xpf.Gauges.Localization
  [Expand]DevExpress.Xpf.Grid
  [Expand]DevExpress.Xpf.Grid.ConditionalFormatting
  [Expand]DevExpress.Xpf.Grid.LookUp
  [Expand]DevExpress.Xpf.Grid.TreeList
  [Expand]DevExpress.Xpf.Layout.Core
  [Collapse]DevExpress.Xpf.LayoutControl
   [Expand]DataLayoutControl Class
   [Expand]DataLayoutControlAutoGeneratedGroupEventArgs Class
    DataLayoutControlAutoGeneratedItemsLocation Enumeration
   [Expand]DataLayoutControlAutoGeneratingItemEventArgs Class
   [Expand]DataLayoutItem Class
    Dock Enumeration
   [Expand]DockLayoutControl Class
   [Expand]FlowLayoutControl Class
   [Expand]GroupBox Class
    GroupBoxDisplayMode Enumeration
    GroupBoxShadowVisibility Enumeration
    GroupBoxState Enumeration
   [Collapse]LayoutControl Class
     LayoutControl Members
     LayoutControl Constructor
    [Collapse]LayoutControl Properties
      AllowAvailableItemsDuringCustomization Property
      AllowHorizontalSizing Attached Property
      AllowItemMovingDuringCustomization Property
      AllowItemRenamingDuringCustomization Property
      AllowItemSizing Property
      AllowItemSizingDuringCustomization Property
      AllowNewItemsDuringCustomization Property
      AllowVerticalSizing Attached Property
      AvailableItems Property
      Controller Property
      CustomizationControlStyle Property
      CustomizationLabel Attached Property
      IsCustomization Property
      IsRoot Property
      ItemCustomizationToolbarStyle Property
      ItemInsertionPointIndicatorStyle Property
      ItemLabelsAlignment Property
      ItemParentIndicatorStyle Property
      Items Property
      ItemSelectionIndicatorStyle Property
      ItemSizerStyle Property
      LayoutUri Property
      MovingItemPlaceHolderBrush Property
      StretchContentHorizontally Property
      StretchContentVertically Property
      TabHeader Attached Property
      TabHeaderTemplate Attached Property
      UseDesiredHeightAsMaxHeight Attached Property
      UseDesiredWidthAsMaxWidth Attached Property
    [Expand]LayoutControl Events
    [Expand]LayoutControl Methods
   [Expand]LayoutControlBase Class
   [Expand]LayoutControlInitNewElementEventArgs Class
   [Expand]LayoutControlReadElementFromXMLEventArgs Class
   [Expand]LayoutControlWriteElementToXMLEventArgs Class
   [Expand]LayoutGroup Class
    LayoutGroupView Enumeration
   [Expand]LayoutItem Class
    LayoutItemLabelPosition Enumeration
    LayoutItemLabelsAlignment Enumeration
    MaximizedElementPosition Enumeration
   [Expand]ScrollBox Class
   [Expand]Tile Class
   [Expand]TileClickEventArgs Class
   [Expand]TileLayoutControl Class
    TileSize Enumeration
  [Expand]DevExpress.Xpf.Map
  [Expand]DevExpress.Xpf.NavBar
  [Expand]DevExpress.Xpf.Navigation
  [Expand]DevExpress.Xpf.PdfViewer
  [Expand]DevExpress.Xpf.PivotGrid
  [Expand]DevExpress.Xpf.PivotGrid.Printing
  [Expand]DevExpress.Xpf.Printing
  [Expand]DevExpress.Xpf.Printing.Parameters
  [Expand]DevExpress.Xpf.Printing.Parameters.Models
  [Expand]DevExpress.Xpf.Printing.PreviewControl
  [Expand]DevExpress.Xpf.Printing.PreviewControl.Bars
  [Expand]DevExpress.Xpf.Prism
  [Expand]DevExpress.Xpf.PropertyGrid
  [Expand]DevExpress.Xpf.Reports.UserDesigner
  [Expand]DevExpress.Xpf.Reports.UserDesigner.Extensions
  [Expand]DevExpress.Xpf.Reports.UserDesigner.Localization
  [Expand]DevExpress.Xpf.Reports.UserDesigner.ReportWizard
  [Expand]DevExpress.Xpf.Reports.UserDesigner.ReportWizard.Pages
  [Expand]DevExpress.Xpf.Ribbon
  [Expand]DevExpress.Xpf.RichEdit
  [Expand]DevExpress.Xpf.RichEdit.Menu
  [Expand]DevExpress.Xpf.Scheduler
  [Expand]DevExpress.Xpf.Scheduler.Drawing
  [Expand]DevExpress.Xpf.Scheduler.Menu
  [Expand]DevExpress.Xpf.Scheduler.Reporting
  [Expand]DevExpress.Xpf.Scheduler.UI
  [Expand]DevExpress.Xpf.Scheduling
  [Expand]DevExpress.Xpf.Scheduling.Editors
  [Expand]DevExpress.Xpf.Scheduling.Reporting
  [Expand]DevExpress.Xpf.Scheduling.Visual
  [Expand]DevExpress.Xpf.SpellChecker
  [Expand]DevExpress.Xpf.Spreadsheet
  [Expand]DevExpress.Xpf.Spreadsheet.Menu
  [Expand]DevExpress.Xpf.TreeMap
  [Expand]DevExpress.Xpf.Utils.Themes
  [Expand]DevExpress.Xpf.WindowsUI
  [Expand]DevExpress.Xpf.WindowsUI.Internal
  [Expand]DevExpress.Xpf.WindowsUI.Navigation
  [Expand]DevExpress.XtraRichEdit
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

LayoutControl.AllowNewItemsDuringCustomization Property

Gets or sets whether an end-user can add new items (e.g. groups) in Customization Mode.

Namespace:DevExpress.Xpf.LayoutControl
Assembly:DevExpress.Xpf.LayoutControl.v17.2.dll

Expanded Syntax

Property value

Type: Boolean
true if an end-user can add new items (e.g. groups) in Customization mode; otherwise, false.

Expanded Remarks

If the AllowNewItemsDuringCustomization property is set to true, an end-user can add new items (e.g. groups) in Customization Mode. To enable this feature, the AllowAvailableItemsDuringCustomization property must also be set to true.

You can customize properties of newly created items by handling the InitNewElement event.

To add new groups via the Available Items list, do the following:

  1. Hover over a button at the Layout Control's top left corner:

    This invokes the Available Items list:

  2. Drag-and-drop "New Group Box" or "New Tabbed Group" items to the layout.

    The "New Group Box" item creates a new LayoutGroup object whose LayoutGroup.View property is set to LayoutGroupView.GroupBox.

    The "New Tabbed Group" item creates a new LayoutGroup object whose LayoutGroup.View property is set to LayoutGroupView.Tabs. The created group contains two tabs.

If the AllowNewItemsDuringCustomization and AllowAvailableItemsDuringCustomization properties are enabled, it's possible to add new tabs to a tabbed group as follows:

  1. Select a tabbed group to show a context window with customization buttons.
  2. Click the '+' customization button:

    This adds a new LayoutGroup as a child of the tabbed group.

After groups are created, you can move layout items to the groups, using drag-and-drop.

Expanded See Also

How would you rate this topic?​​​​​​​