[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Collapse]ASP.NET Core Bootstrap Controls
  Getting Started
  Grid View
  Charts
 [Expand]Site Navigation
 [Expand]Site Layout
 [Collapse]Data Editors
   Button
   Button Edit
   Calendar
   Check Box
   Check Box List
   Combo Box
   Date Edit
   List Box
   Memo
   Progress Bar
   Radio Button
   Radio Button List
   Spin Edit
   Text Box
 [Expand]Redistribution and Deployment
 [Expand]API Reference
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Combo Box

The Bootstrap Combo Box editor combines the functionality of a single-line text editor, button editor, and dropdown list editor. The editor's dropdown displays a list of items that can be selected by end-users.

Bootstrap Combo Box offers the following features.

  • Data-Bound and Unbound Modes Support

    Editor content can be generated dynamically by binding the editor to a data source, as well as manually populating the control's item collection. When retrieving items from the data source, item characteristics such as the text, value, and image are obtained from specific data fields. These data fields can be either defined manually using an item's FieldName property or are obtained automatically, provided that the data fields in the data source are named like the item's characteristics (Text, ImageURL, Value).

  • Incremental Filtering

    You can enable your end-users to filter list items dynamically, based upon the text typed into the editor's input box on the client side (find-as-you-type filtering). The following filter modes are available.

    Loading Mode Description
    StartsWith The editor is filtered for list items that begin with the search string.
    Contains The editor is filtered for list items that contain the search string. The found search string is highlighted within items for clarity.

    You can enable the required filter mode using the DevExpress.AspNetCore.Bootstrap.BootstrapComboBoxBuilder.IncrementalFilteringMode method.

  • Delayed Filtering

    You can define the time interval between the time a user starts typing within the editor's edit box (the DevExpress.AspNetCore.Bootstrap.BootstrapComboBoxBuilder.IncrementalFilteringDelay method) and the time filtering is applied. Moreover, when the Bootstrap Combo Box editor is in incremental filtering mode, it has the capability to start filtering only after an end-user has typed a specific number of symbols in the editor's text box (call the DevExpress.AspNetCore.Bootstrap.BootstrapComboBoxBuilder.FilterMinLength method).

  • Display Formatting

    Editor display values can be formatted using the standard formatting mechanism. The DevExpress.AspNetCore.Bootstrap.BootstrapComboBoxBuilder.TextFormatString method allows you to define the pattern used to format the selected item's text displayed within the editor's edit box.

  • Item Images

    You can define images for individual items (see the BootstrapListEditItemBuilder.IconCssClass method). Images associated with list items are displayed within the editor's dropdown list. The selected item image can be displayed within the editor's edit box in addition to the text.

  • Customizable Button Collection

    The Bootstrap Combo Box control provides a collection to maintain its custom edit buttons. Each button exposes a set of properties allowing the button's appearance and behavior to be defined. The settings of the default button, which invokes the dropdown window when clicked, can be customized as well.

  • Built-in Validation

    The Bootstrap Combo Box control allows you to perform data validation both on the client and server side.

  • Full-Featured Client-Side API

    Bootstrap Combo Box provides you with a comprehensive client-side API. This API is implemented using JavaScript and is exposed using the BootstrapClientComboBox object. The BootstrapClientComboBox object serves as a client-side equivalent of the Bootstrap Combo Box control.

    You can modify the editor behavior using the following methods.

    Method Description
    ASPxClientComboBox.AddItem Adds a new item to the editor, specifying the item's display text, and returns the index of the added item.
    ASPxClientComboBox.BeginUpdate Prevents the client combobox editor from being rendered until the EndUpdate method is called.
    ASPxClientComboBox.ClearItems Removes all items from the client combo box editor.
    ASPxClientComboBox.EndUpdate Re-enables editor render operations after a call to the BeginUpdate method and forces an immediate re-rendering.
    ASPxClientComboBox.FindItemByText Returns a combo box item by its text.
    ASPxClientComboBox.FindItemByValue Returns a combo box item by its value.
    ASPxClientComboBox.GetItem Returns an item specified by its index within the combo box editor's item collection.
    ASPxClientComboBox.GetItemCount Gets the number of items contained in the editor's item collection.
    ASPxClientComboBox.GetSelectedIndex Returns the index of the selected item within the combo box editor.
    ASPxClientComboBox.GetSelectedItem Returns the combo box editor's selected item.
    ASPxClientComboBox.GetText Gets the text displayed in the editor's edit box.
    ASPxClientComboBox.InsertItem Adds a new item to the control's items collection at the specified index.
    ASPxClientComboBox.MakeItemVisible Scrolls the editor's item list, so that the specified item becomes visible.
    ASPxClientComboBox.PerformCallback Sends a callback to the server and generates the server-side ASPxAutoCompleteBoxBase.Callback event, passing it the specified argument.
    ASPxClientComboBox.RemoveItem Removes an item specified by its index from the client list editor.
    ASPxClientComboBox.SetSelectedIndex Sets the combobox editor's selected item specified by its index.
    ASPxClientComboBox.SetSelectedItem Sets the list editor's selected item.
    ASPxClientComboBox.SetText Specifies the text displayed within the editor's edit box.

Expanded See Also

Is this topic helpful?​​​​​​​