BootstrapComboBoxProperties.EnableMultiColumn Property

Enables the Combo Box’s multi-column mode.

Namespace: DevExpress.Web.Bootstrap

Assembly: DevExpress.Web.Bootstrap.v24.1.dll

NuGet Package: DevExpress.Web.Bootstrap

Declaration

C#

[DefaultValue(false)]
public bool EnableMultiColumn { get; set; }

VB.NET

<DefaultValue(False)>
Public Property EnableMultiColumn As Boolean

Property Value

Type	Default	Description
Boolean	false	true to enable multi-column mode; otherwise, false.

Remarks

The Combo Box can be displayed as a table with multiple columns. Each column displays data from a corresponding data source field. A column header is generated based on its specified field name.

To enable multi-column mode in a Combo Box, follow the steps below:

1. Populate the Fields collection with names of data source fields that supply data for Combo Box columns.

   Note

   Unbound Combo Box controls do not support multi-column mode. Do not use the EnableMultiColumn property with the Combo Box’s Items collection.

2. Set the EnableMultiColumn property to true.

3. (Optional) Use the field’s SettingsMultiColumn property to customize a corresponding column’s header, tooltip, and width.

<dx:BootstrapComboBox runat="server" 
                      DataSourceID="WWICountriesDataSource" 
                      EnableMultiColumn="true" 
                      ValueField="CountryID">
    <Fields>
        <dx:BootstrapListBoxField FieldName="IsoAlpha3Code">
            <SettingsMultiColumn Caption="Code" ToolTip="IsoAlpha3Code" Width="50px" />
        </dx:BootstrapListBoxField>
        <dx:BootstrapListBoxField FieldName="CountryName" />
        <dx:BootstrapListBoxField FieldName="Region" />
        <dx:BootstrapListBoxField FieldName="Subregion" />
    </Fields>
</dx:BootstrapComboBox>

Note

Online Demo: Combo Box - Multi Column

The EnableMultiColumn property synchronizes its value with the editor’s BootstrapComboBox.EnableMultiColumn property.