[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Collapse]WPF Controls
 [Expand]What's Installed
 [Expand].NET Core 3 Support
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Collapse]Controls and Libraries
  [Expand]Data Grid
  [Expand]Ribbon, Bars and Menu
  [Expand]Charts Suite
  [Expand]Pivot Grid
  [Expand]Rich Text Editor
  [Expand]Tree List
  [Expand]Gauge Controls
  [Expand]Map Control
  [Expand]Layout Management
  [Expand]Windows Modern UI
  [Collapse]Data Editors
    Included Components
   [Expand]Implementation Details
   [Expand]Getting Started
   [Collapse]Editor Types
     Token Editors
   [Expand]Common Features
   [Expand]Range Control
   [Expand]Visual Elements
   [Expand]End-User Capabilities
  [Expand]Navigation Controls
  [Expand]Spell Checker
  [Expand]Property Grid
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Gantt Control
  [Expand]Diagram Control
  [Expand]Windows and Utility Controls
   Dialogs, Notifications and Panels
  [Expand]Scheduler (legacy)
 [Expand]Scaffolding Wizard
  Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)


Expanded Overview

The ComboBoxEdit control is a dropdown list that supports various operation modes.

The ComboBoxEdit control offers the following features.

  • Lookup functionality

    The editor can load values for its dropdown list from a data field. The actual edit value (usually, ID) is fetched from a different field.

  • Customizable dropdown list size and optional size grip

    You can specify the dropdown list size using the ComboBoxEdit's PopupBaseEdit.PopupWidth and PopupBaseEdit.PopupHeight properties. To enable the size grip, set the ComboBoxEdit's PopupBaseEdit.ShowSizeGrip property to true. The size grip allows end-users to change the dropdown size at runtime.

  • Customizable item appearance

    You can completely change the appearance of ComboBoxEdit items using WPF templates. Use the ComboBoxEdit's LookUpEditBase.ItemTemplate property to specify the item template.

  • Optional OK and Cancel buttons

    Use the ComboBoxEdit's PopupBaseEdit.PopupFooterButtons property to display the "OK" and "Cancel" buttons within the dropdown.

  • Token mode

    Token and CheckedToken operation modes are inspired by modern mail-clients. These modes support multiple items selection.

    Set the ComboBoxEdit's BaseEdit.StyleSettings property to the TokenComboBoxStyleSettings object to enable the Token Combo Box operation mode.

    For a complete list of ComboBoxEdit operation modes, see ComboBoxEdit operation modes.

  • Optimized for in-place editing

    ComboBoxEdit can be used standalone or as an in-place editor nested in a container control. The ComboBoxEditSettings class implements the in-place editing functionality. See In-place Editors to learn more.

  • Edit Values

    The BaseEdit.EditValueChanged event occurs when the editor's edit value is changed. Handle the LookUpEditBase.PopupContentSelectionChanged event if you need to perform custom actions when another item within the editor's dropdown is selected (highlighted).

Expanded Standalone ComboBoxEdit

To add a standalone ComboBoxEdit to a Window, drag it from the Toolbox.

The following sample demonstrates how to create a CheckedTokenComboBoxEdit using XAML markup.

Expanded In-place ComboBoxEdit

To embed a ComboBoxEdit into a container control, use the ComboBoxEditSettings class.

The following sample demonstrates how to embed a ComboBoxEdit into a GridControl column.

Expanded See Also

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