wpf-116556-controls-and-libraries-data-editors-common-features-editor-operation-modes-lookupedit.md
The lookup editor’s StyleSettings property allows you to fine-tune the editor. This property allows you to alter the appearance and behavior of a lookup editor, for example, by adding a search and selecting multiple items. To apply specific settings, assign the lookup’s StyleSettings property to one of the objects listed in the table below:
|
Mode
|
Corresponding settings object
|
Description
| | --- | --- | --- | |
|
|
Editor’s dropdown displays a grid. This is a default setting.
| |
|
|
Editor’s dropdown displays a grid and a search box.
| |
|
MultiSelectLookUpEditStyleSettings
|
Editor’s dropdown displays a grid that allows you to select multiple items.
| |
|
|
Editor’s dropdown displays a grid that allows you to select multiple items.
Selected items appear as tokens.
| |
|
SearchTokenLookUpEditStyleSettings
|
Editor’s dropdown displays a grid and a search box. Allows multiple item selection.
Selected items appear as tokens.
|
Each of the settings objects has properties you can use to enable or disable the following grid features:
The code example below shows a lookup editor in SearchLookUp mode with the grouping feature disabled:
<dxg:LookUpEdit SeparatorString="; ">
<dxg:LookUpEdit.StyleSettings>
<dxg:SearchLookUpEditStyleSettings AllowGrouping="False"/>
</dxg:LookUpEdit.StyleSettings>
</dxg:LookUpEdit>
The following sections describe different LookUpEdit control settings:
LookUpEdit is the default mode.
The editor’s dropdown displays a fully-functional grid that supports the following features:
The following example adds a LookUpEdit to an app form:
<Window ...
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:dxg="http://schemas.devexpress.com/winfx/2008/xaml/grid"
...>
<Grid VerticalAlignment="Center">
<dxg:LookUpEdit ItemsSource="{x:Static local:Helper.Data}"
DisplayMember="Name"
IsTextEditable="False"
SeparatorString="; ">
<dxg:LookUpEdit.StyleSettings>
<dxg:LookUpEditStyleSettings AllowGrouping="False"/>
</dxg:LookUpEdit.StyleSettings>
</dxg:LookUpEdit>
</Grid>
</Window>
Tip
For more information and examples, refer to the following help topics:
In addition to LookUpEdit features, SearchLookUpEdit displays the embedded GridControl’s search panel. This panel allows users to find information within the data grid.
Tip
For more information and examples, refer to the following help topic: SearchLookUpEditStyleSettings
In addition to LookUpEdit features, MultiSelectLookUpEdit supports multiple item selection.
Tip
For more information and examples, refer to the following help topic: MultiSelectLookUpEditStyleSettings
TokenLookupEdit mode is inspired by modern mail clients.
In addition to LookUpEdit features, TokenLookupEdit supports the following:
Tip
For more information and examples, refer to the following help topic: TokenLookUpEditStyleSettings
SearchTokenLookupEdit mode is inspired by modern mail clients.
In addition to LookUpEdit features, SearchTokenLookupEdit supports the following:
Tip
For more information and examples, refer to the following help topic: SearchTokenLookUpEditStyleSettings.
The table below compares the features of different LookUpEdit operation modes:
| Grouping | Filtering | Sorting | Single Item Selection | Multiple Item Selection[1] | Search | Tokens | Text Editing | |
|---|---|---|---|---|---|---|---|---|
| LookUpEdit | ||||||||
| SearchLookUpEdit | ||||||||
| MultiselectLookUpEdit | ||||||||
| TokenLookUpEdit | ||||||||
| SearchTokenLookUpEdit |
Footnotes
See Also