Skip to main content
Bar

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

PopupMenu.MultiColumn Property

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

Namespace: DevExpress.XtraBars

Assembly: DevExpress.XtraBars.v24.2.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 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, 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