BarLinkContainerItem.MultiColumn Property
Gets or sets whether the sub-menu items are displayed in multiple columns.
Namespace: DevExpress.XtraBars
Assembly: DevExpress.XtraBars.v24.1.dll
NuGet Package: DevExpress.Win.Navigation
Declaration
[DefaultValue(DefaultBoolean.Default)]
[DXCategory("Behavior")]
public DefaultBoolean MultiColumn { get; set; }
Property Value
Type | Default | Description |
---|---|---|
DefaultBoolean | Default | A DefaultBoolean enumeration value that specifies whether the sub-menu items are displayed in multiple columns. |
Available values:
Name | Description | Return Value |
---|---|---|
True | The value is true. |
|
False | The value is false. |
|
Default | The value is specified by a global option or a higher-level object. |
|
Remarks
By default, when this property equals Default, items in sub-menus (BarSubItem objects) are displayed in one column. You can set the MultiColumn property to True to display the current menu’s items in multiple columns. The BarLinkContainerItem.OptionsMultiColumn property provides access to the settings applied to the multicolumn mode. For example, the number or columns can be specified by the BarLinkContainerItem.OptionsMultiColumn.ColumnCount property; visibility of item captions is controlled by the BarLinkContainerItem.OptionsMultiColumn.ShowItemText property.
The following image shows the same sub-menu whose items are displayed in single and multiple columns.
If items in the sub-menu are divided into groups using headers (BarHeaderItem objects), you can override the multicolumn mode settings for the group of items below a particular header using the BarHeaderItem.MultiColumn and BarHeaderItem.OptionsMultiColumn properties.
Moreover, you can use the BarAndDockingController component to control multicolumn mode settings in a centralized way. The BarManagerProperties.OptionsMultiColumn property, accessible using the BarAndDockingController.PropertiesBar property, allows you specify multicolumn mode settings for all sub-menus and pop-up menus controlled by the BarManager (see BarManager.Controller). The settings provided using the sub-menu’s BarLinkContainerItem.OptionsMultiColumn property override these global settings.