Tab

ASPxGridLookup.SelectionMode Property

Gets or sets a value that specifies item selection behavior.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v20.2.dll

Declaration

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

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.

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).

See Also