[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
  Prerequisites
 [Expand]What's Installed
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Expand]Controls and Libraries
 [Expand]Scaffolding Wizard
 [Expand]Localization
  Redistribution and Deployment
  Get More Help
 [Collapse]API Reference
  [Expand]DevExpress.Charts.Designer
  [Expand]DevExpress.Data
  [Expand]DevExpress.Mvvm.UI
  [Expand]DevExpress.Mvvm.UI.Interactivity
  [Expand]DevExpress.Mvvm.UI.ModuleInjection
  [Expand]DevExpress.Xpf.Accordion
  [Expand]DevExpress.Xpf.Bars
  [Expand]DevExpress.Xpf.Carousel
  [Expand]DevExpress.Xpf.Charts
  [Expand]DevExpress.Xpf.Charts.Localization
  [Expand]DevExpress.Xpf.Charts.RangeControlClient
  [Expand]DevExpress.Xpf.ChunkList
  [Expand]DevExpress.Xpf.Controls
  [Expand]DevExpress.Xpf.Core
  [Expand]DevExpress.Xpf.Core.ConditionalFormatting
  [Expand]DevExpress.Xpf.Core.DataSources
  [Expand]DevExpress.Xpf.Core.FilteringUI
  [Expand]DevExpress.Xpf.Core.Native
  [Expand]DevExpress.Xpf.Core.ServerMode
  [Expand]DevExpress.Xpf.Data
  [Expand]DevExpress.Xpf.DataAccess
  [Expand]DevExpress.Xpf.DataAccess.DataSourceWizard
  [Expand]DevExpress.Xpf.Diagram
  [Expand]DevExpress.Xpf.Dialogs
  [Expand]DevExpress.Xpf.Docking
  [Expand]DevExpress.Xpf.Docking.Base
  [Expand]DevExpress.Xpf.DocumentViewer
  [Expand]DevExpress.Xpf.DXBinding
  [Collapse]DevExpress.Xpf.Editors
    ActivationAction Enumeration
   [Expand]AreaSparklineStyleSettings Class
    AutoCompleteType Enumeration
   [Expand]AutoSuggestEdit Class
    AutoSuggestEditChangeTextReason Enumeration
   [Expand]AutoSuggestEditCustomPopupHighlightedTextEventArgs Class
   [Expand]AutoSuggestEditQuerySubmittedEventArgs Class
   [Expand]AutoSuggestEditSuggestionChosenEventArgs Class
   [Expand]AutoSuggestEditTextChangedEventArgs Class
   [Expand]BarCodeEdit Class
   [Expand]BarCodePropertyProvider Class
   [Expand]BarSparklineStyleSettings Class
   [Expand]BaseComboBoxStyleSettings Class
   [Expand]BaseEdit Class
   [Expand]BaseEditStyleSettings Class
   [Expand]BaseProgressBarStyleSettings Class
   [Expand]ButtonEdit Class
   [Expand]ButtonInfo Class
   [Expand]ButtonInfoBase Class
   [Expand]ButtonInfoCollection Class
    ButtonKind Enumeration
   [Expand]Calculator Class
   [Expand]CalculatorCustomErrorTextEventArgs Class
    CalculatorCustomErrorTextEventHandler Delegate
   [Expand]CameraControl Class
   [Expand]CameraDevice Class
   [Expand]CheckedComboBoxStyleSettings Class
   [Expand]CheckEdit Class
   [Expand]CheckEditBox Class
    CheckEditDisplayMode Enumeration
   [Expand]CheckedListBoxEditStyleSettings Class
   [Expand]CheckedTokenComboBoxStyleSettings Class
    ChipSize Enumeration
   [Expand]ClosePopupEventArgs Class
    ClosePopupEventHandler Delegate
    ColorDisplayFormat Enumeration
   [Expand]ColorEdit Class
   [Expand]ColorPalette Class
   [Collapse]ComboBoxEdit Class
     ComboBoxEdit Members
     ComboBoxEdit Constructor
    [Expand]ComboBoxEdit Properties
   [Expand]ComboBoxEditItem Class
   [Expand]ComboBoxStyleSettings Class
    ContentDisplayMode Enumeration
   [Expand]ConvertEditValueEventArgs Class
   [Expand]CustomDisplayTextEventArgs Class
    CustomDisplayTextEventHandler Delegate
   [Expand]CustomPalette Class
   [Expand]DateEdit Class
   [Expand]DateEditCalendarStyleSettings Class
   [Expand]DateEditPickerStyleSettings Class
   [Expand]DeleteButtonInfo Class
   [Expand]EditableDataObject Class
    EditMode Enumeration
   [Expand]EditorLocalizer Class
    EditorPlacement Enumeration
    EditorStringId Enumeration
   [Expand]EditValueChangedEventArgs Class
    EditValueChangedEventHandler Delegate
   [Expand]EditValueChangingEventArgs Class
    EditValueChangingEventHandler Delegate
   [Expand]ErrorControl Class
    FindMode Enumeration
   [Expand]FontEdit Class
    GlyphKind Enumeration
    HighlightedTextCriteria Enumeration
   [Expand]HyperlinkEdit Class
   [Expand]HyperlinkEditRequestNavigationEventArgs Class
   [Expand]ImageCheckEditStyleSettings Class
   [Expand]ImageEdit Class
   [Expand]LineSparklineStyleSettings Class
   [Expand]ListBoxEdit Class
   [Expand]ListBoxEditItem Class
   [Expand]ListBoxEditStyleSettings Class
   [Expand]LookUpEditBase Class
    MaskType Enumeration
   [Expand]MemoEdit Class
    NewTokenPosition Enumeration
   [Expand]NumericMaskOptions Class
   [Expand]PagerControl Class
   [Expand]PaletteCollection Class
   [Expand]PasswordBoxEdit Class
    PasswordStrength Enumeration
   [Expand]PasswordStrengthEventArgs Class
   [Expand]PopupBaseEdit Class
   [Expand]PopupCalcEdit Class
    PopupCloseMode Enumeration
   [Expand]PopupColorEdit Class
    PopupFooterButtons Enumeration
   [Expand]PopupImageEdit Class
    PostMode Enumeration
   [Expand]PredefinedColorCollections Class
   [Expand]PredefinedPaletteCollections Class
   [Expand]ProcessNewValueEventArgs Class
    ProcessNewValueEventHandler Delegate
   [Expand]ProgressBarEdit Class
   [Expand]ProgressBarMarqueeStyleSettings Class
   [Expand]ProgressBarStyleSettings Class
   [Expand]RadioComboBoxStyleSettings Class
   [Expand]RadioListBoxEditStyleSettings Class
   [Expand]Range Class
   [Expand]RangeBaseEdit Class
   [Expand]RatingControl Class
   [Expand]RatingEdit Class
   [Expand]RatingItem Class
    RatingPrecision Enumeration
    ScrollUnit Enumeration
   [Expand]SearchControl Class
    ShowLoadDialogOnClickMode Enumeration
    ShowMenuMode Enumeration
   [Expand]SparklineEdit Class
    SparklineSortOrder Enumeration
   [Expand]SparklineStyleSettings Class
    SparklineViewType Enumeration
   [Expand]SpinEdit Class
   [Expand]SpinEventArgs Class
    SpinEventHandler Delegate
    SpinStyle Enumeration
   [Expand]TextEdit Class
   [Expand]TextEditBase Class
    TimeSpanInputMode Enumeration
   [Expand]TimeSpanMaskOptions Class
    TimeSpanPart Enumeration
   [Expand]ToggleSwitch Class
    ToggleSwitchAnimationMode Enumeration
    ToggleSwitchContentPlacement Enumeration
   [Expand]ToggleSwitchEdit Class
   [Expand]TokenActivatingEventArgs Class
   [Expand]TokenComboBoxStyleSettings Class
   [Expand]TokenEditorBehavior Class
   [Expand]TokensChangedEventArgs Class
   [Expand]TokensChangingEventArgs Class
   [Expand]TokenStateChangedEventArgs Class
   [Expand]TokenTextChangingEventArgs Class
   [Expand]TrackBarEdit Class
   [Expand]TrackBarEditRange Class
    TrackBarIncrementTargetEnum Enumeration
   [Expand]TrackBarRangeStyleSettings Class
   [Expand]TrackBarStyleSettings Class
   [Expand]TrackBarZoomRangeStyleSettings Class
   [Expand]TrackBarZoomStyleSettings Class
   [Expand]ValidationEventArgs Class
   [Expand]WinLossSparklineStyleSettings Class
  [Expand]DevExpress.Xpf.Editors.DataPager
  [Expand]DevExpress.Xpf.Editors.DateNavigator
  [Expand]DevExpress.Xpf.Editors.ExpressionEditor
  [Expand]DevExpress.Xpf.Editors.ExpressionEditor.Native
  [Expand]DevExpress.Xpf.Editors.Filtering
  [Expand]DevExpress.Xpf.Editors.Flyout
  [Expand]DevExpress.Xpf.Editors.Flyout.Native
  [Expand]DevExpress.Xpf.Editors.Helpers
  [Expand]DevExpress.Xpf.Editors.Native
  [Expand]DevExpress.Xpf.Editors.Popups
  [Expand]DevExpress.Xpf.Editors.RangeControl
  [Expand]DevExpress.Xpf.Editors.Settings
  [Expand]DevExpress.Xpf.Editors.Validation
  [Expand]DevExpress.Xpf.ExpressionEditor
  [Expand]DevExpress.Xpf.Gantt
  [Expand]DevExpress.Xpf.Gauges
  [Expand]DevExpress.Xpf.Gauges.Localization
  [Expand]DevExpress.Xpf.Grid
  [Expand]DevExpress.Xpf.Grid.ConditionalFormatting
  [Expand]DevExpress.Xpf.Grid.LookUp
  [Expand]DevExpress.Xpf.Grid.TreeList
  [Expand]DevExpress.Xpf.Layout.Core
  [Expand]DevExpress.Xpf.LayoutControl
  [Expand]DevExpress.Xpf.Map
  [Expand]DevExpress.Xpf.NavBar
  [Expand]DevExpress.Xpf.Navigation
  [Expand]DevExpress.Xpf.PdfViewer
  [Expand]DevExpress.Xpf.PivotGrid
  [Expand]DevExpress.Xpf.PivotGrid.Printing
  [Expand]DevExpress.Xpf.Printing
  [Expand]DevExpress.Xpf.Printing.Parameters
  [Expand]DevExpress.Xpf.Printing.Parameters.Models
  [Expand]DevExpress.Xpf.Printing.PreviewControl
  [Expand]DevExpress.Xpf.Printing.PreviewControl.Bars
  [Expand]DevExpress.Xpf.Prism
  [Expand]DevExpress.Xpf.PropertyGrid
  [Expand]DevExpress.Xpf.Reports.UserDesigner
  [Expand]DevExpress.Xpf.Reports.UserDesigner.Extensions
  [Expand]DevExpress.Xpf.Reports.UserDesigner.Localization
  [Expand]DevExpress.Xpf.Reports.UserDesigner.ReportWizard
  [Expand]DevExpress.Xpf.Reports.UserDesigner.ReportWizard.Pages
  [Expand]DevExpress.Xpf.Ribbon
  [Expand]DevExpress.Xpf.RichEdit
  [Expand]DevExpress.Xpf.RichEdit.Menu
  [Expand]DevExpress.Xpf.Scheduler
  [Expand]DevExpress.Xpf.Scheduler.Drawing
  [Expand]DevExpress.Xpf.Scheduler.Menu
  [Expand]DevExpress.Xpf.Scheduler.Reporting
  [Expand]DevExpress.Xpf.Scheduler.UI
  [Expand]DevExpress.Xpf.Scheduling
  [Expand]DevExpress.Xpf.Scheduling.Common
  [Expand]DevExpress.Xpf.Scheduling.Editors
  [Expand]DevExpress.Xpf.Scheduling.iCalendar
  [Expand]DevExpress.Xpf.Scheduling.Reporting
  [Expand]DevExpress.Xpf.Scheduling.Visual
  [Expand]DevExpress.Xpf.Scheduling.VisualData
  [Expand]DevExpress.Xpf.SpellChecker
  [Expand]DevExpress.Xpf.Spreadsheet
  [Expand]DevExpress.Xpf.Spreadsheet.Menu
  [Expand]DevExpress.Xpf.TreeMap
  [Expand]DevExpress.Xpf.Utils.Themes
  [Expand]DevExpress.Xpf.WindowsUI
  [Expand]DevExpress.Xpf.WindowsUI.Internal
  [Expand]DevExpress.Xpf.WindowsUI.Navigation
  [Expand]DevExpress.XtraRichEdit
  [Expand]DevExpress.XtraRichEdit.Printing
[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)

ComboBoxEdit Class

A combobox editor.

Namespace:DevExpress.Xpf.Editors
Assembly:DevExpress.Xpf.Core.v19.1.dll

Expanded Syntax

Expanded Remarks

Expanded Create a ComboBoxEdit

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

Expanded Bind to Data

Use the LookUpEditBase.ItemsSource property to bind the ComboBoxEdit to an System.Collections.IEnumerable source.

Bind to a List of Simple Objects

Bind to a Collection of Objects

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

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

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

Expanded Edit Value and Display Text

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

The BaseEdit.DisplayText property returns the text displayed in the ComboBoxEdit.

Expanded ComboBoxEdit Modes

The ComboBoxEdit supports six modes:

  • default

  • checked

  • radio

  • token

  • radio token

  • checked token

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

Combobox (Default)

The mode object: ComboBoxStyleSettings.

Checked Combobox

The mode object: CheckedComboBoxStyleSettings.

Radio Button Combobox

The mode object: RadioComboBoxStyleSettings.

Token Combobox

The mode object: TokenComboBoxStyleSettings.

Checked Token Combobox

The mode object: CheckedTokenComboBoxStyleSettings.

Expanded Auto Complete

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

In the auto complete mode, the ComboBoxEdit can highlight the item in the dropdown that matches the user input. To enable item highlighting, set the LookUpEditBase.IncrementalSearch property to true.

Expanded Incremental Filtering

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

Tip

Demo: ComboBoxEdit

Requires installation of WPF Subscription. Download

Expanded Inheritance Hierarchy

System.Object
    System.Windows.Threading.DispatcherObject
       System.Windows.DependencyObject
          System.Windows.Media.Visual
             System.Windows.UIElement
                System.Windows.FrameworkElement
                   System.Windows.Controls.Control
                      BaseEdit
                         TextEditBase
                            TextEdit
                               ButtonEdit
                                  PopupBaseEdit
                                     LookUpEditBase
                                        ComboBoxEdit
                                           AppointmentLabelEdit
                                           AppointmentLabelEdit
                                           AppointmentResourceEdit
                                           AppointmentResourceEdit
                                           AppointmentResourcesEdit
                                           AppointmentResourcesEdit
                                           AppointmentStatusEdit
                                           AppointmentStatusEdit
                                           DevExpress.Xpf.Scheduler.UI.CheckedResourcesComboBoxControlBase
                                           DurationEdit
                                           DevExpress.Xpf.Scheduler.UI.FixedSourceComboBoxEdit
                                           FontEdit
                                           ItemComboBoxEdit
                                           MonthEdit
                                           ResourcesComboBoxControl
                                           DevExpress.Xpf.Scheduler.UI.ResourcesComboBoxControlBase
                                           ResourcesPopupCheckedListBoxControl
                                           DevExpress.Xpf.Scheduler.UI.SchedulerBoundComboBoxEdit
                                           DevExpress.Xpf.Scheduler.UI.StorageBoundComboBoxEdit
                                           TimeZoneEdit
                                           TimeZoneEdit
                                           WeekDaysEdit
                                           WeekOfMonthEdit

Expanded See Also

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