Skip to main content
Bar

PopupMenu.MultiColumn Property

Gets or sets whether the menu items are displayed across multiple columns.

Namespace: DevExpress.XtraBars

Assembly: DevExpress.XtraBars.v22.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

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

Property Value

Type Default Description
DefaultBoolean Default

A DefaultBoolean enumeration value that specifies whether the menu items are displayed in multiple columns.

Available values:

Name Description
True

true. DefaultBoolean.True has a constant value of 0, while the standard true value corresponds to a value of 1. In Visual Basic, do not use implicit conversion of Boolean values to DefaultBoolean, and vice versa, as the conversion may produce incorrect results.

False

false. DefaultBoolean.False has a constant value of 1, while the standard false value corresponds to a value of 0. In Visual Basic, do not use implicit conversion of Boolean values to DefaultBoolean, and vice versa, as the conversion may produce incorrect results.

Default

The default behavior determined by the control’s logic.

Remarks

By default, PopupMenu items are displayed within a single column. Set the MultiColumn property to True to display items in the current menu across multiple columns. When using multi-column mode, settings can be modified using the PopupMenu.OptionsMultiColumn property. For example, the number or columns can be specified by the PopupMenu.OptionsMultiColumn.ColumnCount property; visibility of item captions is controlled by the PopupMenu.OptionsMultiColumn.ShowItemText property.

The following images show the same pop-up menu whose items are displayed across single and multiple columns.

BarHeaderItem_SingeColumnBarHeaderItem_MultipleColumnsEntireMenu

If items in the pop-up 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 to specify multicolumn mode settings for all pop-up menus and sub-menus controlled by the BarManager (see BarManager.Controller). The settings provided using the current pop-up menu’s PopupMenu.OptionsMultiColumn property override these global settings.

See Also