Skip to main content
Bar

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.

0

False

The value is false.

1

Default

The value is specified by a global option or a higher-level object.

2

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.

BarHeaderItem_SingeColumnBarHeaderItem_MultipleColumnsEntireMenu

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.

See Also