ASPxGridLookup.SelectionMode Property

Gets or sets a value that specifies item selection behavior.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v24.2.dll

Declaration

C#

[DefaultValue(GridLookupSelectionMode.Single)]
public GridLookupSelectionMode SelectionMode { get; set; }

VB.NET

<DefaultValue(GridLookupSelectionMode.Single)>
Public Property SelectionMode As GridLookupSelectionMode

Property Value

Type	Default	Description
GridLookupSelectionMode	Single	One of the GridLookupSelectionMode enumeration values.

Available values:

Name	Description
Single	Only one list item can be selected at one time.
Multiple	Multiple items can be selected within the editor’s dropdown list.

Remarks

The SelectionMode property specifies how many list items (grid rows) can be selected simulateneously within the dropdown ASPxGridView control.

ASPX

<dx:ASPxGridLookup ID="gridLookup" runat="server" SelectionMode="Multiple" ...>
    <Columns>
        <dx:GridViewCommandColumn ShowSelectCheckbox="True" SelectAllCheckboxMode="AllPages" />
        <!-- ... -->
    </Columns>
    <!-- ... -->
</dx:ASPxGridLookup>

View Example: How to enable multiple selection

For more information about available selection modes, read the Selection Modes topic.

Note

• When the multiple selection mode is enabled (the SelectionMode property is set to Multiple), incremental filtering does not work.
• In single-selection mode, the GridLookup always synchronizes its value with the focused row in the drop-down grid when a user sorts grid columns, navigates through pages,etc. You can press ESC to rollback a newly selected value and restore an original editor’s value.

Note

The SelectionMode property synchronizes its value with the ASPxGridViewBehaviorSettings.AllowSelectSingleRowOnly property (which can be accessed through the GridViewProperties.SettingsBehavior property).