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.v24.2.dll

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	Return Value
True	The value is true.	0
False	The value is false.	1
Default	The value is specified by a global option or a higher-level object.	2

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.