TdxBarItemLink.BeginGroup Property

Specifies whether the item control that corresponds to the current item link starts a group.

Declaration

property BeginGroup: Boolean read; write; default False;

Property Value

Type	Default
Boolean	False

Remarks

When this property is set to True the item control follows a group separator.

Do not confuse these groups with item groups which are designed to simultaneously manage the visibility and accessibility of multiple bar items.

When the value of the BeginGroup property is changed, the item control’s BeginGroupChanged method is called and then a bar manager’s OnItemLinkChange event is generated.

At design time, you can switch the BeginGroup property value using the Customizing Popup Menu. End-users can manage group separators in customization mode as described below.

• In toolbars and submenus, end-users can create a group separator by dragging an item control a short distance to the end of a toolbar/submenu while the Customization Form is open. Dragging an item control to the opposite direction removes a group separator before this item control (if any).

• In the Ribbon Quick Access Toolbar, end-users can manage group separators using “<Separator>” items (commands) provided by the Quick Access Toolbar Customization form. These items can be added like any other items (commands) from the “Choose commands from” list to the “Customize Quick Access Toolbar” list, moved to a required position within it, or removed. Use the sdxRibbonCustomizationFormBeginGroup resource string to localize the item’s caption.

Note

An item control whose VisibleIndex property is equal to 0 or -1 cannot start a group.