Back to Devexpress

Quick Runtime Customization

windowsforms-17515-controls-and-libraries-form-layout-managers-layout-and-data-layout-controls-design-time-and-runtime-customization-quick-runtime-customization.md

latest5.7 KB
Original Source

Quick Runtime Customization

  • Jun 23, 2020
  • 3 minutes to read

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.

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.

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.

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

  • Item Customization Buttons

  • Grouping Buttons

See Also

Customization Form - Layout Control

Runtime Undo/Redo

Save and Restore Form Layout

Design-Time Customization

Default Runtime Customization

Runtime Customization Overview