[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications, and Dialogs
  [Collapse]Editors and Simple Controls
   [Collapse]Simple Editors
    [Expand]Included Components
    [Expand]Editors Structure
    [Collapse]Editors Features
      Text Editing Overview
     [Expand]Mask Editors Overview
     [Expand]Format and Parse Editor Values
     [Expand]Editor Buttons
     [Collapse]Dropdown Editors Overview
       BLOB Editors
       Combo Box Editors
       Popup Container Editor
      Image Editing Menu
     [Expand]Data Binding Overview
     [Expand]Appearance Customization
     [Expand]Miscellaneous Features
    [Expand]Member Tables
    [Expand]Examples
   [Expand]Lookup Editors
   [Expand]Token Edit Control
   [Expand]Breadcrumb Edit Control
   [Expand]Range Control
   [Expand]Image Slider
    Camera Control
    Templated ListBox Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Expand]Pivot Grid
  [Expand]Member Tables
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Diagrams
  [Expand]Gauges
  [Expand]Map Control
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]Printing-Exporting
  [Expand]PDF Viewer
   Reporting
  [Expand]Snap
  [Expand]TreeMap Control
  [Expand]Sunburst Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[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)

Dropdown Editors Overview

Expanded Dropdown Editors

Dropdown editors are controls that use popup windows to provide access to editor-specific data (a list of items to select, memo data, image, etc). Dropdown editors included in the XtraEditors library are listed below.

Note

The XtraScheduler and other libraries provide additional dropdown editors, which you may find useful. See descendants of the PopupBaseEdit class for a complete list of DevExpress WinForms dropdown editors.

Dropdown Editors

Repository Item

Description

BreadCrumbEdit

RepositoryItemBreadCrumbEdit

The MS Windows Explorer-inspired navigation bar that allows end-users to navigate through a hierarchical tree of nodes.

CalcEdit

RepositoryItemCalcEdit

Allows you to edit numeric values using a dropdown calculator.

CheckedComboBoxEdit

RepositoryItemCheckedComboBoxEdit

An editor that displays a list of check boxes in a drop-down menu. Users can select multiple items.

ColorEdit

RepositoryItemColorEdit

The editor that allows you to select a color from a dropdown window.

ColorPickEdit

RepositoryItemColorPickEdit

An advanced dropdown color picker that supports multiple palettes (a predefined color palette, Web, Web-Safe and System) to choose colors from.

ComboBoxEdit

RepositoryItemComboBox

The text editor that allows you to select predefined items from a dropdown list. List items are typically represented by strings.

DateEdit

RepositoryItemDateEdit

The editor to edit date/time values using a dropdown calendar.

FontEdit

RepositoryItemFontEdit

The editor to select a font from a dropdown list.

ImageComboBoxEdit

RepositoryItemImageComboBox

The combo box editor whose items can display custom images. The control also allows values from an enumeration to be displayed.

ImageEdit

RepositoryItemImageEdit

The editor that displays images in a popup window.

LookUpEdit

RepositoryItemLookUpEdit

The editor that provides lookup functionality using a lightweight grid in a drop-down window.

See also: GridLookUpEdit, SearchLookUpEdit, TreeListLookUpEdit.

MemoExEdit

RepositoryItemMemoExEdit

The editor to edit multi-line text in a popup window.

MRUEdit

RepositoryItemMRUEdit

The text editor that allows you to type a value or choose one of most recently used (MRU) values from a dropdown list.

PopupContainerEdit

RepositoryItemPopupContainerEdit

The editor that allows you to display any controls within its popup window.

PopupGalleryEdit

RepositoryItemPopupGalleryEdit

The editor that displays a dropdown gallery of items categorized into groups.

TimeEdit

RepositoryItemTimeEdit

The editor to edit time values using spin buttons or dropdown calendar.

TimeSpanEdit

RepositoryItemTimeSpanEdit

The editor to display and edit time intervals.

Expanded Common Features of Dropdown Editors

Properties, methods and events common for all dropdown editors are provided by the PopupBaseEdit and RepositoryItemPopupBase classes that serve as the base for editor and repository item classes respectively.

The popup window can be activated by clicking the editor button whose index is assigned to the RepositoryItemPopupBase.ActionButtonIndex property. End-users can also press the ALT+DOWN ARROW key combination or the shortcut specified by the RepositoryItemPopupBase.CloseUpKey property. To open the popup via code, call the PopupBaseEdit.ShowPopup method. In every case, the PopupBaseEdit.QueryPopUp event is raised before the popup window is actually opened. The handler is able to stop the dropdown from appearing.

End-users can close the dropdown window by accepting or discarding their choice. Similarly, you can use two methods to close the dropdown window: PopupBaseEdit.ClosePopup and PopupBaseEdit.CancelPopup, to accept or discard changes, respectively.

When closing a popup window, the PopupBaseEdit.QueryCloseUp and PopupBaseEdit.CloseUp events are raised. The first event can be used to prevent the window closing, provided that the user does not switch focus away from the control. The PopupBaseEdit.CloseUp event fires in all cases and only provides notification that the window has been closed.

Expanded See Also

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