BarLinkContainerItem.MultiColumn Property

Gets or sets whether the sub-menu items are displayed in multiple columns.

Assembly : DevExpress.XtraBars.v25.2.dll

NuGet Package : DevExpress.Win.Navigation

Declaration

C#
VB.NET

csharp

[DefaultValue(DefaultBoolean.Default)]
[DXCategory("Behavior")]
public DefaultBoolean MultiColumn { get; set; }

<DefaultValue(DefaultBoolean.Default)>
<DXCategory("Behavior")>
Public Property MultiColumn As DefaultBoolean

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.

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.