LookUpEdit Class

In This Article

Declaration

Represents the Lookup editor.

Namespace: DevExpress.Xpf.Grid.LookUp

Assembly: DevExpress.Xpf.Grid.v14.2.dll

#Declaration

C#
VB.NET

[DXToolboxBrowsable(true)]
[ToolboxTabName("DX.14.2: Common Controls")]
[DataAccessMetadata("All", SupportedProcessingModes = "Simple")]
public class LookUpEdit :
    LookUpEditBase

<DXToolboxBrowsable(True)>
<ToolboxTabName("DX.14.2: Common Controls")>
<DataAccessMetadata("All", SupportedProcessingModes:="Simple")>
Public Class LookUpEdit
    Inherits LookUpEditBase

#Remarks

This a multi-column combo box that provides the lookup functionality, using an embedded DXGrid control for Silverlight.

LookUpEdit

Its features include:

Display and edit values can be taken from separate data fields, specified by the LookUpEditBase.DisplayMember and LookUpEditBase.ValueMember properties, respectively.
Multiple sort modes including auto-completion and incremental filtering (LookUpEditBase.AutoComplete, LookUpEditBase.IncrementalFiltering).
Custom processing for entering not-in-list values. The LookUpEditBase.ProcessNewValue event can be handled to insert new records into the underlying data source (LookUpEditBase.ItemsSource).
Embedded DXGrid Control.
A nearly unlimited set of options to customize the dropdown list by exploiting the features provided by the DXGrid Control. These include customizable columns collection, data summaries, sorting, grouping and filtering dropdown list data by column values, and much more.

Lookup Editor can be used both as a standalone editor and an in-place editor within the DXGrid Control.

#Example

This example shows how to customize the Silverlight DXGrid Control displayed within the Lookup editor's popup window.

XAML


<dxg:LookUpEdit Name="lookUpEdit1"
                        DisplayMember="ProductName"
                        ValueMember="ID"
                        AutoPopulateColumns="False"
                        AutoComplete="True"
                        IncrementalFiltering="True"
                        ImmediatePopup="True"
                        IsPopupAutoWidth="False"
                        HorizontalAlignment="Center"
                        VerticalAlignment="Top"
                        Width="200" Margin="10">
            <dxg:LookUpEdit.PopupContentTemplate>
                <ControlTemplate>
                    <dxg:GridControl Name="PART_GridControl">
                        <dxg:GridControl.Columns>
                            <dxg:GridColumn FieldName="ProductName"/>
                            <dxg:GridColumn FieldName="UnitPrice"/>
                            <dxg:GridColumn FieldName="Quantity"/>
                        </dxg:GridControl.Columns>
                        <dxg:GridControl.View>
                            <dxg:TableView AutoWidth="True"/>
                        </dxg:GridControl.View>
                    </dxg:GridControl>
                </ControlTemplate>
            </dxg:LookUpEdit.PopupContentTemplate>
        </dxg:LookUpEdit>