Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [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]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Diagrams
  [Expand]Gauges
  [Expand]Map Control
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Collapse]Form Layout Managers
    Side Panel
   [Collapse]Layout Manager
    [Expand]Product Information
    [Expand]Getting Started
    [Expand]Layout Control
    [Expand]Data Layout Control
    [Expand]Layout Item
    [Expand]Layout Groups
    [Expand]Tabbed Group
    [Expand]Other Layout Elements
    [Collapse]Customization Capabilities
      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]Miscellaneous
    [Expand]Examples
    [Expand]Member Tables
   [Expand]Tabbed MDI Manager
    Tab Control
   [Expand]Wizard Control
    Workspace Manager
  [Expand]Navigation Controls
  [Expand]Printing-Exporting
  [Expand]PDF Viewer
   Reporting
  [Expand]Snap
  [Expand]TreeMap Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Quick Runtime Customization

The LayoutControl supports two customization modes: default and quick. In default mode, customization commands are provided using context menus; while in quick mode, these commands are available in the touch-friendly Customization Form. You can select the appropriate mode by setting the LayoutControl.CustomizationMode property to Default or Quick.

For general information on runtime customization, how to disable this feature and how to save and restore layouts, see Runtime Customization Overview. To learn the specifics of the default customization mode, see Default Runtime Customization.

Expanded Quick Customization Mode Activation

To activate quick customization mode, an end-user has to press and hold a finger (on touch devices) or press and hold a right-click with a mouse within the LayoutControl's bounds until an animated load indicator is filled.

After that, all elements residing within the LayoutControl will be disabled and the touch-oriented Customization Form will be displayed showing customization options for the clicked item.

You can regulate various aspects of quick mode initialization using options provided by the LayoutControl.OptionsCustomizationForm:
Note

Layout item context menus are not available in quick customization mode.

Expanded Customization Form

The Customization Form provides various control elements (buttons encapsulating customization actions, a text box specifying a selected element caption, Properties grid, etc.). Its appearance depends on the type of selected element. The following image demonstrates the Customization Form invoked for a LayoutControl's root group.

To access the Customization Form's extended capabilities, click the Show more/fewer options button . This displays additional elements: Hidden Items and Layout Tree View tabbed pages and Properties grid.

The LayoutControl.OptionsCustomizationForm property contains the settings that determine the availability of the specific elements of a Customization Form.

Expanded Layout Customization

In customization mode, an end-user is able to modify a layout using the drag-and-drop functionality, resizing operations and actions provided by the Customization Form.

An end-user can rename a layout item by selecting it and typing the required text in the Customization Form dedicated field. This field is synchronized with the item's Text property.

The Customization Form displays buttons that provide various customization capabilities.

  • General Customization Buttons
    Saves the current layout to an XML file.
    Loads one of the previously saved layouts from an XML file.
    Perform undo and redo customization operations.
    Automatically calculates and applies optimal element sizes.
    Extends/shrinks the Customization Form to show more/fewer options.
    Chooses the selected element's parent group.
  • Item Customization Buttons
    Adds a new item representing an empty region (an Empty Space Item).
    Hides the currently selected items and groups.
    Apply custom or default size constraints. See Size and Alignment to learn more.
    Specify the vertical (Top, Middle or Bottom) and horizontal (Left, Center or Right) label alignment.
    Specify the label position, group caption position or tabbed group page header position (Top, Bottom, Left or Right).
    Shows/hides the selected item's label.
    Specify the Control Alignment.
  • Grouping Buttons
    Groups the currently selected items (creates a new group and adds the selected items to it).
    Ungroups the currently selected group (destroys the currently selected group and moves its items to the parent group.).
    Creates a new tabbed group from the selected group or adds a new tabbed page to the selected tabbed group.
    Ungroups the currently selected tabbed group (destroys the selected tabbed group and moves its tabbed pages to the parent group).

Expanded See Also

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