The requested page is not available for the requested platform. You are viewing the content for Default platform.

Multi-Column Mode of List Editors

  • 2 min to read

The ASPxComboBox and ASPxListBox editors from the ASPxEditors Suite allow their list data to be represented in several columns.

Note

The multi-column mode is in effect only for editors that obtain their items from a data source.

An editor's column collection can be defined and customized through the Columns property. This is the ASPxComboBox.Columns property for the ASPxComboBox editor, and the ASPxListBox.Columns property for the ASPxListBox editor. The Columns property provides access to a collection of the ListBoxColumnCollection type. Collection items are represented by instances of the ListBoxColumn class.

Each column within an editor's column collection should be bound to a data source field via the ListBoxColumn.FieldName property. You can also define a column's header caption WebColumnBase.Caption, width (WebColumnBase.Width), visibility state (WebColumnBase.Visible), unique identifier (WebColumnBase.Name) and tooltip text (WebColumnBase.ToolTip).

For the ASPxComboBox control, all its advanced features, such as incremental filtering and loading items on demand via callbacks, are supported in multi-column mode. The selected item is represented within the ASPxComboBox editor's edit box, using a value whose format is based upon the ASPxAutoCompleteBoxBase.TextFormatString property's setting.

Note

When you use a multi-column mode of list editors, item values are not saved to the ViewState. So, if you don't want to get data from data source on every page load (while performing DataBinding), you should organize your own cache (e.g. in the Session).

Online Demo

ASPxComboBox (Multiple Columns)