GridOptionsSelection.ShowCheckBoxSelectorChangesSelectionNavigation Property

Gets or sets whether multiple row selection in the check box column can be changed while navigating through grid rows with the keyboard.

Namespace: DevExpress.XtraGrid.Views.Grid

Assembly: DevExpress.XtraGrid.v21.2.dll

NuGet Packages: DevExpress.Win.Design, DevExpress.Win.Grid

Declaration

C#

[Browsable(false)]
[DefaultValue(DefaultBoolean.Default)]
[XtraSerializableProperty]
public virtual DefaultBoolean ShowCheckBoxSelectorChangesSelectionNavigation { get; set; }

VB.NET

<DefaultValue(DefaultBoolean.Default)>
<XtraSerializableProperty>
<Browsable(False)>
Public Overridable Property ShowCheckBoxSelectorChangesSelectionNavigation As DefaultBoolean

Property Value

Type	Default	Description
DefaultBoolean	Default	Default or True if multiple rows can be selected in the check box column when navigating through the grid with the keyboard; False to synchronize the focused and selected row when navigating using the keyboard.

Available values:

Name	Description
True	true. DefaultBoolean.True has a constant value of 0, while the standard true value corresponds to a value of 1. In Visual Basic, do not use implicit conversion of Boolean values to DefaultBoolean, and vice versa, as the conversion may produce incorrect results.
False	false. DefaultBoolean.False has a constant value of 1, while the standard false value corresponds to a value of 0. In Visual Basic, do not use implicit conversion of Boolean values to DefaultBoolean, and vice versa, as the conversion may produce incorrect results.
Default	The default behavior determined by the control’s logic.

Property Paths

You can access this nested property as listed below:

Object Type	Path to ShowCheckBoxSelectorChangesSelectionNavigation
GridView	.OptionsSelection .ShowCheckBoxSelectorChangesSelectionNavigation

Remarks

By default, end-users are allowed to select multiple rows while navigating through the grid with the keyboard. Setting the ShowCheckBoxSelectorChangesSelectionNavigation property to False enables the automatic selection of the focused row, while the row losing focus is automatically deselected. In this mode, only one row focused with the keyboard is selected at one time.