Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[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
 [Collapse]Controls and Libraries
  [Expand]Windows and Utility Controls
   Dialogs, Notifications and Panels
   Reporting
  [Expand]Data Grid
  [Expand]Ribbon, Bars and Menu
  [Expand]Charts Suite
  [Expand]Pivot Grid
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Tree List
  [Expand]Gauge Controls
  [Expand]Map Control
  [Expand]Layout Management
  [Expand]Windows Modern UI
  [Expand]Printing-Exporting
  [Collapse]Data Editors
    Included Components
   [Expand]Implementation Details
   [Expand]Getting Started
   [Expand]Editor Types
   [Collapse]Common Features
    [Expand]Obtaining Editor Values
    [Expand]Binding to Data
     In-Place Mode
    [Collapse]Editor Operation Modes
      LookUpEdit
      ComboBoxEdit
      ListBoxEdit
      DateEdit
      ProgressBarEdit
      SparklineEdit
      TrackBarEdit
    [Expand]Masked Input
    [Expand]Input Validation
     Incremental Search
   [Expand]Range Control
   [Expand]Visual Elements
   [Expand]End-User Capabilities
   [Expand]Examples
  [Expand]Navigation Controls
  [Expand]Spell Checker
  [Expand]Property Grid
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Diagram Control
  [Expand]Scheduler (legacy)
 [Expand]Scaffolding Wizard
 [Expand]Localization
  Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

LookUpEdit

This topic contains the following sections.

Expanded Overview

You can fine-tune a lookup editor by using the BaseEdit.StyleSettings property. This property allows you to alter the appearance and behavior of a lookup editor by adding extra features like searching and multiple item selection. To apply specific settings, assign the lookup's BaseEdit.StyleSettings property to one of the objects listed in the table below.

LookUpEdit mode Corresponding settings object Description
LookUpEdit LookUpEditStyleSettings Editor's dropdown displays a grid. This is a default setting.
SearchLookUpEdit SearchLookUpEditStyleSettings Editor's dropdown displays a grid and a search box.
MultiSelectLookUpEdit MultiSelectLookUpEditStyleSettings Editor's dropdown displays a grid that allows you to select multiple items.
TokenLookUpEdit TokenLookUpEditStyleSettings Editor's dropdown displays a grid that allows you to select multiple items.
Selected items are represented by tokens.
SearchTokenLookUpEdit SearchTokenLookUpEditStyleSettings Editor's dropdown displays a grid and a search box. Allows multiple item selection.
Selected items are represented by tokens.

Additionally, each of the settings objects has a number of properties that you can use to enable or disable the following grid features.

The code example below shows a lookup editor in the SearchLookUp mode with grouping feature disabled.

The following sections describe different settings provided by the LookUpEdit control in detail.

Expanded LookUpEdit

LookUpEdit mode is used by default.

Editor's dropdown displays a fully-functional grid that supports the following features.

  • single item selection;
  • data filtering;
  • data grouping;
  • data sorting.

To learn more, see LookUpEditStyleSettings.

Expanded SearchLookUpEdit

In addition to the standard features, SearchLookUpEdit displays a search box.

To learn more, see SearchLookUpEditStyleSettings

Expanded MultiSelectLookUpEdit

In addition to the standard features, MultiSelectLookUpEdit supports multiple item selection.

To learn more, see MultiSelectLookUpEditStyleSettings.

Expanded TokenLookUpEdit

TokenLookupEdit mode is inspired by modern mail clients.

In addition to the standard features, TokenLookupEdit supports the following:

  • multiple items selection;
  • selected items are represented by tokens.

To learn more, see TokenLookUpEditStyleSettings.

Expanded SearchTokenLookUpEdit

SearchTokenLookupEdit mode is inspired by modern mail clients.

In addition to the standard features, SearchTokenLookupEdit supports the following:

  • data search;
  • multiple items selection;
  • selected items are represented by tokens.

To learn more, see SearchTokenLookUpEditStyleSettings.

Expanded LookUpEdit Modes Comparison

The table below compares the features of different LookUpEdit operation modes.

Grouping Filtering Sorting Single item selection Multiple item selection Search Tokens
LookUpEdit + + + + - - -
SearchLookUpEdit + + + + - + -
MultiselectLookUpEdit + + + + + - -
TokenLookUpEdit + + + + + - +
SearchTokenLookUpEdit + + + + + + +

Expanded See Also

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