[Expand]General Information
[Collapse]WinForms Controls
  .NET Core Support
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications, and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Gantt Control
  [Expand]Chart Control
  [Expand]Map Control
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Collapse]Form Layout Managers
    Side Panel
   [Collapse]Layout and Data Layout Controls
    [Expand]Product Information
    [Expand]Getting Started
    [Expand]Layout Control
    [Expand]Data Layout Control
    [Expand]Layout Items
    [Expand]Layout Groups
    [Expand]Tabbed Groups
    [Expand]Other Layout Elements
    [Collapse]Design-Time and Runtime Customization
      Design-Time Customization
      Design-Time Actions: Adding and Removing Controls and Layout Items
      Design-Time Actions: Resizing and Moving Layout Items
      Design-Time Actions: Selecting Controls and Layout Items
      Context Menu
      Customization Form
      Runtime Undo/Redo
      Creating Layout Items at Design Time
      Creating Tabbed Groups at Design Time
      Design-Time Layout Templates
      Dragging Layout Items at Design Time
      Layout Tree View
      Selecting Layout Items at Design Time
      Runtime Customization Overview
      Default Runtime Customization
      Quick Runtime Customization
    [Expand]Size and Alignment
     Flow Layout
     Table Layout
     Focus Management
    [Expand]Appearance and Look and Feel
    [Expand]Member Tables
   [Expand]Tabbed MDI Manager
    Tab Control
   [Expand]Wizard Control
    Workspace Manager
  [Expand]Navigation Controls
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Sunburst Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Customization Form

The LayoutControl allows a layout to be modified at design time and runtime (in customization mode). The Customization Form, along with the Context Menu, provides design-time and runtime layout customization capabilities.

This document describes the default Customization Form, which is available at design time and in default runtime customization mode. To learn about the Customization Form capabilities in quick runtime customization mode, see Quick Runtime Customization.

Expanded Showing and Hiding Customization Form

At design time, customization mode is always enabled. However, certain customization features (e.g., the ability to hide/restore items) are accessible only when the Customization Form is visible.

The Customization Form can be opened by right-clicking a LayoutControl's empty space and selecting the Customize Layout command from the context menu. At runtime, opening the Customization Form enables customization mode.

The following animation demonstrates basic customization operations using the Customization Form: hiding and displaying items, accessing the item hierarchy, and changing item properties.

The LayoutControl.ShowCustomizationForm method allows invoking the Customization Form from code.

The Customization Form can be closed by an end-user or hidden programmatically at runtime by using the LayoutControl.HideCustomizationForm method. To respond to closing the form at runtime, handle the LayoutControl.HideCustomization event.

Expanded Customization Form Features

The Customization Form allows you and your end-users to:

  • Hide specific items and restore hidden items using drag and drop.
  • Add Empty Space Items, Labels, Separators and Splitters from the Hidden Items tab to the layout using drag and drop.
  • Modify item properties using the built-in Property Grid.
  • Access the hierarchical structure of layout items and modify it using drag-and-drop operations directly within the Layout Tree View.
  • Save the current layout to an XML file and restore the previously saved layout.
  • Undo and redo the customization operations.

The Customization Form can be treated as an instance of the System.Windows.Forms.Form class. The LayoutControl.CustomizationForm property provides access to the Customization Form. This property allows you to customize the form as needed (change a caption, size, etc.). The How to: Create custom customization form topic shows how to implement a custom Customization Form.

Expanded Customization Form Elements

The image and table below describe the Customization Form elements:

Customization Form Elements


Hidden Items Tab

This pane displays "fixed" items and hidden items, and supports drag-and-drop to/from the Layout Control. To hide an item, drag it from the Layout Control to the Hidden Items list. To add a hidden or fixed item to the layout, drag it to the Layout Control.

The "fixed" items are the Empty Space Item, Label, Separator and Splitter. They are always displayed at the top of the list and are painted in bold.

The "fixed" items are actually not instances, but rather types of items. When any of the fixed items is dragged and dropped onto the Layout Control, an instance of the corresponding item is created. It's possible to create a custom fixed item and register it with the LayoutControl.RegisterFixedItemType method.

Layout Tree View Tab

The Layout Tree View displaying the hierarchical structure of the Layout Control makes it easy to select layout items, especially those that are hidden by other items or that are small enough to grip them with the mouse. Selecting a tree element highlights the corresponding item in the Layout Control (and vice versa), and displays its properties in the Property Grid. For tree elements, you can invoke the context menu with common customization commands. Pressing the DELETE key deletes the selected layout item. Items can be dragged and dropped within the tree, and between the Layout Control and the tree.

Save and Load Buttons

These buttons allow you and your end-users to save the current layout to an XML file and then restore it.

Undo and Redo Buttons

The Undo button allows your end-user to undo the very last action. Clicking the Redo button reverts to the state existing before the undo operation. These buttons are available only at runtime.

Property Grid

Settings of a selected layout item can be accessed and modified in the embedded Property Grid.

The Layout Control provides options to modify the visibility of the Customization Form elements. These options can be accessed from the LayoutControl.OptionsCustomizationForm property.

Expanded See Also

Is this topic helpful?​​​​​​​