ComboBoxEdit Class

A combobox editor.

Namespace: DevExpress.Xpf.Editors

Assembly: DevExpress.Xpf.Core.v24.1.dll

NuGet Package: DevExpress.Wpf.Core

Declaration

C#

public class ComboBoxEdit :
    LookUpEditBase,
    ISelectorEdit,
    IBaseEdit,
    IInputElement

VB.NET

Public Class ComboBoxEdit
    Inherits LookUpEditBase
    Implements ISelectorEdit,
               IBaseEdit,
               IInputElement

Related API Members

The following members return ComboBoxEdit objects:

• FilterPopupEventArgs.ComboBoxEdit

Remarks

Combobox Editor

Checked Combobox

Radio Combobox

Token Combobox

Tip

The ComboBoxEdit class inherits its features from the LookUpEditBase class.

Refer to the LookUpEditBase class description for information on derived features and API.

Create a ComboBoxEdit

Use the ComboBoxEdit.Items property to add items. This property is marked with the ContentPropertyAttribute, so in XAML you can add elements to the group between the start and end ComboBoxEdit tags.

XAML

<Window ...
    xmlns:dxe="http://schemas.devexpress.com/winfx/2008/xaml/editors">

<dxe:ComboBoxEdit>
    <dxe:ComboBoxEditItem>Item1</dxe:ComboBoxEditItem>
    <dxe:ComboBoxEditItem>Item2</dxe:ComboBoxEditItem>
    <dxe:ComboBoxEditItem>Item3</dxe:ComboBoxEditItem>
</dxe:ComboBoxEdit>
...

Bind to Data

Use the ItemsSource property to bind the ComboBoxEdit to an IEnumerable source.

Bind to a List of Simple Objects

Xaml

<dxe:ComboBoxEdit ItemsSource="{Binding}"/> 

C#

using System;
using System.Collections.Generic;
using System.Windows;

namespace ComboBoxSample {
    public partial class MainWindow : Window {
        public MainWindow() {
            InitializeComponent();
            this.DataContext = new List<string>(){"Item 1", "Item 2", "Item 3"};
        }
    }
} 

Bind to a Collection of Objects (Lookup Mode)

To bind the ComboBoxEdit to a collection of objects, use the DisplayMember and ValueMember properties.

The DisplayMember property specifies a source field name whose values are used as item display text.

The ValueMember property specifies a source field name whose values are used as actual item values. If this property is not specified, the ComboBoxEdit returns the source object itself.

Xaml

<dxe:ComboBoxEdit 
    ItemsSource="{Binding}" 
    DisplayMember="Name"
    ValueMember="Id"/> 

C#

using System;
using System.Collections.Generic;

namespace ComboBoxSample {
    public partial class MainWindow : Window {
        public MainWindow() {
            InitializeComponent();
            this.DataContext = new ObservableCollection<Customer>(){
                new Customer(){ Id = 1, Name = "Gregory S. Price" },
                new Customer(){ Id = 2, Name = "Irma R. Marshall" },
                new Customer(){ Id = 3, Name = "John C. Powell" }
            };
        }
    }
    public class Customer {
        public int Id { get; set; }
        public string Name { get; set; }
    }
} 

Note

When the DisplayMember and ValueMember properties are specified, the ComboBoxEdit allows users to enter only the values from its ItemsSource.

Bind to Enumeration Values

You can bind the ComboBoxEdit to enumeration values in any of the following ways:

• Use the SetupComboBoxEnumItemSource<T, DataType>(LookUpEditBase) method.
• Use the EnumItemsSourceBehavior.

Edit Value and Display Text

The ComboBoxEdit value is specified by the EditValue property. To respond to edit value changes, handle the BaseEdit.EditValueChanging and BaseEdit.EditValueChanged events.

The DisplayText property returns the text displayed in the ComboBoxEdit.

Edit Value in Multiselect Mode

If an editor works in checked, token, or checked token mode, it allows end users to select multiple data items at once. In this case, the editor’s EditValue property returns a list of Objects. You can cast these objects to the following:

• The type of bound data items if an editor is bound to simple objects or is in lookup mode (the ValueMember property is not specified).
• The type of the data field specified in the ValueMember property.

View Example: Create a Checked ComboBox

Refer to the following help topic for more information: Multiple Selection in ComboBoxEdit, LookUpEdit, and ListBoxEdit.

ComboBoxEdit Operation Modes

The ComboBoxEdit supports the following operation modes:

• default
• checked
• radio
• token
• checked token

To specify a mode, set the StyleSettings property to the corresponding mode object.

Combobox (Default)

The mode object: ComboBoxStyleSettings.

Xaml

<dxe:ComboBoxEdit ItemsSource="{Binding Customers}">
    <dxe:ComboBoxEdit.StyleSettings>
        <dxe:ComboBoxStyleSettings />
    </dxe:ComboBoxEdit.StyleSettings>
</dxe:ComboBoxEdit>

Checked Combobox

The mode object: CheckedComboBoxStyleSettings.

Xaml

<dxe:ComboBoxEdit ItemsSource="{Binding Customers}">
    <dxe:ComboBoxEdit.StyleSettings>
        <dxe:CheckedComboBoxStyleSettings />
    </dxe:ComboBoxEdit.StyleSettings>
</dxe:ComboBoxEdit> 

Radio Button Combobox

The mode object: RadioComboBoxStyleSettings.

Xaml

<dxe:ComboBoxEdit ItemsSource="{Binding Cities}">
    <dxe:ComboBoxEdit.StyleSettings>
        <dxe:RadioComboBoxStyleSettings />
    </dxe:ComboBoxEdit.StyleSettings>
</dxe:ComboBoxEdit>

Token Combobox

The mode object: TokenComboBoxStyleSettings.

Xaml

<dxe:ComboBoxEdit ItemsSource="{Binding Cities}">
    <dxe:ComboBoxEdit.StyleSettings>
        <dxe:TokenComboBoxStyleSettings />
    </dxe:ComboBoxEdit.StyleSettings>
</dxe:ComboBoxEdit>

Checked Token Combobox

The mode object: CheckedTokenComboBoxStyleSettings.

Xaml

<dxe:ComboBoxEdit ItemsSource="{Binding Cities}">
    <dxe:ComboBoxEdit.StyleSettings>
        <dxe:CheckedTokenComboBoxStyleSettings />
    </dxe:ComboBoxEdit.StyleSettings>
</dxe:ComboBoxEdit>

Customize Appearance

Refer to the Appearance Customization topic for more information on how to customize ComboBoxEdit and ListBox item appearance.

Auto Complete

The ComboBoxEdit can automatically complete the text typed by a user to a valid value. To enable automatic completion, set the AutoComplete property to true.

Xaml

<dxe:ComboBoxEdit 
                 AutoComplete="True" 
                 ItemsSource="{Binding Cities}" />

Enable the LookUpEditBase.ImmediatePopup option to display the editor dropdown when a user starts to type:

Xaml

<dxe:ComboBoxEdit 
    AutoComplete="True"
    ImmediatePopup="True"
    ItemsSource="{Binding Cities}" />

Incremental Filtering

The ComboBoxEdit can filter items on user input. To enable incremental filtering, set the IncrementalFiltering property to true. To enable case-sensitive filtering, set the LookUpEditBase.IsCaseSensitiveFilter property to true.

Xaml

<dxe:ComboBoxEdit 
                 IncrementalFiltering="True" 
                 ItemsSource="{Binding Countries}" />

Run Demo: ComboBoxEdit

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the ComboBoxEdit class.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

XAML

wpf-data-grid-implement-crud-operations/CS/CodeBehind/EFCore/ServerMode/IssueDetailView.xaml#L12

<dxlc:LayoutItem Label="User">
    <dxe:ComboBoxEdit EditValue="{Binding Item.UserId}" ItemsSource="{Binding EditOperationContext.Users}"
                      ValueMember="Id" DisplayMember="Name"

wpf-synchronous-theme-preload-with-splashscreen/CS/ThemePreloadwithSplashscreen/ComplexWindow.xaml#L63

Label="Prefix">
<dxe:ComboBoxEdit
    MinWidth="75"

wpf-data-grid-bind-master-and-detail-focused-rows-to-viewmodel-properties/CS/Window1.xaml#L18

<StackPanel Orientation="Horizontal" VerticalAlignment="Top" Margin="10,0,10,0">
    <dxe:ComboBoxEdit ItemsSource="{Binding Data}" DisplayMember="Text" Name="comboBoxEdi1" Width="200"/>
    <dxe:ComboBoxEdit ItemsSource="{Binding EditValue.Data, ElementName=comboBoxEdi1}" DisplayMember="Text" Name="comboBoxEdi2" Width="200"/>

wpf-map-get-routes-to-the-destination-point-with-the-bing-map-route-data-service/CS/CalculateRoutesFromMajorRoads/MainWindow.xaml#L18

<sys:String x:Key="bingKey">YOUR_BING_KEY_HERE</sys:String>
<Style TargetType="{x:Type dxe:ComboBoxEdit}">
    <Setter Property="Width" Value="150" />

wpf-gridcontrol-populate-inplace-comboboxedit-with-values-based-on-values-from-other-cells/CS/MainWindow.xaml#L25

<DataTemplate>
    <dxe:ComboBoxEdit DisplayMember="Color"
                      ItemsSource="{Binding View.DataContext.ComboBoxItems}"

Inheritance

Show 32 items

Object

DispatcherObject

DependencyObject

Visual

UIElement

FrameworkElement

Control

BaseEdit

TextEditBase

TextEdit

ButtonEdit

PopupBaseEdit

LookUpEditBase

ComboBoxEdit

FontEdit

ResourcesPopupCheckedListBoxControl

DurationEdit

ItemComboBoxEdit

TimeZoneEdit

AppointmentLabelEdit

AppointmentResourceEdit

AppointmentResourcesEdit

AppointmentLabelEdit

AppointmentResourceEdit

AppointmentResourcesEdit

AppointmentStatusEdit

AppointmentStatusEdit

MonthEdit

ResourcesComboBoxControl

TimeZoneEdit

WeekDaysEdit

WeekOfMonthEdit