Skip to main content

BootstrapListBoxProperties.EnableMultiColumn Property

Enables a List Box’s multi-column mode.

Namespace: DevExpress.Web.Bootstrap

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

NuGet Package: DevExpress.Web.Bootstrap

Declaration

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

Property Value

Type Default Description
Boolean false

true to enable multi-column mode; otherwise, false.

Remarks

The List 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 List Box, follow the steps below:

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

    Note

    Unbound List Box controls do not support multi-column mode. Do not use the EnableMultiColumn property with the List 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:BootstrapListBox 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:BootstrapListBox>

Bootstrap-ListBox-Multi-Column-Mode

Note

Online Demo: List Box - Multi Column

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

See Also