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

BarHeaderItem.OptionsMultiColumn Property

Provides access to the settings of the multicolumn mode of displaying items below the current header.

Namespace: DevExpress.XtraBars

Assembly: DevExpress.XtraBars.v24.2.dll

NuGet Package: DevExpress.Win.Navigation

#Declaration

[DXCategory("Appearance")]
public OptionsMultiColumn OptionsMultiColumn { get; }

#Property Value

Type Description
DevExpress.Utils.Menu.OptionsMultiColumn

An OptionsMultiColumn object that encapsulates the settings of the multicolumn mode.

#Remarks

By setting the BarHeaderItem.MultiColumn property to True you can display items that follow the current BarHeaderItem in multiple columns. The OptionsMultiColumn property provides access the settings that allow you to customize the multicolumn mode. For example, the OptionsMultiColumn.ColumnCount property allows the number of columns to be specified.

The BarLinkContainerItem.OptionsMultiColumn and PopupMenu.OptionsMultiColumn properties provide access to multicolumn mode settings common to all items in sub-menus (BarSubItem objects) and pop-up menus (PopupMenu objects), respectively. The OptionsMultiColumn property overrides these setting for the items that follow the current BarHeaderItem.

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 pop-up menus and sub-menus controlled by the BarManager (see BarManager.Controller). The settings provided using the OptionsMultiColumn property override these global settings.

See Also