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

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 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>

Note

Online Demo: List Box - Multi Column

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