[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 LookUpEdit control is an advanced dropdown editor. Its dropdown contains a fully-functional data grid. The LookupEdit control supports multiple operation modes.

The LookupEdit control offers the following features.

  • Multiple operation modes

    For a complete list of available operation modes, see LookupEdit operation modes.

  • Embedded GridControl

    The LookupEdit control inherits many of the Data Grid's features including customizable columns collection, data summaries, sorting, grouping and filtering dropdown list data by column values.

  • Token mode

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

    Set the LookUpEdit's BaseEdit.StyleSettings property to the TokenLookUpEditStyleSettings object to enable the Token operation mode.

    For the complete list of LookUpEdit operation modes, see LookUpEdit operation modes.

  • Optional Search field

    To display the Search field within the dropdown, use one of the following LookupEdit operation modes.

    • SearchLookupEdit
    • SearchTokenLookupEdit
  • Optimized for in-place editing

    LookUpEdit can be used standalone or as an in-place editor nested in a container control. The LookUpEditSettings 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 LookUpEdit

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

The following sample demonstrates how to create a LookUpEdit and activate its Token mode using XAML markup.

Expanded In-place LookUpEdit

To embed a LookUpEdit into a container control, use the LookUpEditSettings class.

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

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