Runtime Customization Context Menus

• Mar 21, 2024
• 4 minutes to read

The layout control’s built-in customization context menu provides most commonly used customization operations. This menu can only be used at runtime in customization mode.

The menu’s commands are context dependant, which means that different commands are available for different layout elements. You can control the visibility of menu items via a layout control’s MenuItems property.

These include:

Layout Group Context Menu

Layout Item Context Menu

Note

At runtime, multiple layout elements can be selected simultaneously on a form as described in the corresponding section of the On-Form Object Access topic. So, while menu item descriptions in the tables below refer to a single selected element, the same descriptions apply to all the selected elements.

Layout Group Context Menu

Menu Item	Description
Undo	Undoes the last operation performed on a group. This action corresponds to the Undo method of the layout control’s Undo/Redo Manager.
Redo	Redoes the last undo operation performed on a group. This action corresponds to the Redo method of the layout control’s Undo/Redo Manager.
Delete	Deletes a selected group.
Horizontal Alignment	Horizontally aligns a group within a parent container. For a complete list of available horizontal alignment styles, refer to the TdxCustomLayoutItem.AlignHorz description. This action corresponds to the group’s AlignHorz property.
Vertical Alignment	Vertically aligns a group within a parent container. For a complete list of available vertical alignment styles, refer to the TdxCustomLayoutItem.AlignVert description. This action corresponds to the group’s AlignVert property.
Layout Direction	Arranges the group’s contents into different layout styles within the group. For a complete list of available styles, refer to the TdxLayoutDirection description. This action corresponds to the group’s LayoutDirection property.
Border	Changes the group border’s visibility. This action corresponds to the group’s ShowBorder property.
Expand Button	Changes the group expand button’s visibility. This action corresponds to the group’s ButtonOptions.ShowExpandButton property.
Group	Creates a new parent for a selected group, and places the selected group into the parent.
Ungroup	Moves a selected group’s contents to the group’s parent and then deletes this group.
Caption	Changes the group caption’s visibility. This action corresponds to the group’s CaptionOptions.Visible property.
Caption Position	Changes the group caption’s position within a group. This action corresponds to the group’s CaptionOptions.Layout property.
Caption Horizontal Alignment	Changes the horizontal text alignment within the caption position. This action corresponds to the group’s CaptionOptions.AlignHorz property.
Caption Vertical Alignment	Changes the vertical text alignment within the caption position. This action corresponds to the group’s CaptionOptions.AlignVert property.

Layout Item Context Menu

Menu Item	Description
Undo	Undoes the last operation performed on a layout item. This action corresponds to the Undo method of the layout control’s Undo/Redo Manager.
Redo	Redoes the last undo operation performed on a layout item. This action corresponds to the Redo method of the layout control’s Undo/Redo Manager.
Delete	Deletes a selected layout item.
Horizontal Alignment	Horizontally aligns a layout item within a parent container. For a complete list of available horizontal alignment styles, refer to the TdxCustomLayoutItem.AlignHorz description. This action corresponds to the layout item’s AlignHorz property.
Vertical Alignment	Vertically aligns a layout item within a parent container. For a complete list of available vertical alignment styles, refer to the TdxCustomLayoutItem.AlignVert description. This action corresponds to the layout item’s AlignVert property.
Group	Creates a new group for a selected layout item, and places the selected item into the new group.
Caption	Changes the item caption’s visibility. This action corresponds to the item’s CaptionOptions.Visible property.
Caption Position	Changes the item caption’s position within an item. This action corresponds to the item’s CaptionOptions.Layout property.
Caption Horizontal Alignment	Changes the horizontal text alignment within the caption position. This action corresponds to the item’s CaptionOptions.AlignHorz property.
Caption Vertical Alignment	Changes the vertical text alignment within the caption position. This action corresponds to the item’s CaptionOptions.AlignVert property.
Collapsible	Allows or forbids an end user to collapse a layout element associated with a splitter item. This menu item appears only in the selected splitter item’s context menu. This action corresponds to the splitter item’s AllowCloseOnClick property.