Skip to main content

ColumnViewOptionsBehavior.FocusLeaveOnTab Property

Gets or sets whether pressing the TAB key moves focus to the next control in the tab order, if moving focus via the TAB key within the View is prohibited (or cannot be performed).

Namespace: DevExpress.XtraGrid.Views.Base

Assembly: DevExpress.XtraGrid.v24.1.dll

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

Declaration

[DefaultValue(false)]
[XtraSerializableProperty]
public virtual bool FocusLeaveOnTab { get; set; }

Property Value

Type Default Description
Boolean false

true to allow focus to be moved away from the grid control when the TAB key is pressed; otherwise, false.

Property Paths

You can access this nested property as listed below:

Object Type Path to FocusLeaveOnTab
ColumnView
.OptionsBehavior .FocusLeaveOnTab

Remarks

The UseTabKey option (see the GridOptionsNavigation.UseTabKey property in GridViews and the CardOptionsBehavior.UseTabKey property in CardViews) controls focus movement between cells when the TAB key is pressed. If the UseTabKey property is set to true, pressing the TAB key moves focus to the next cell and pressing the SHIFT+TAB key moves focus to the previous cell. By default, when the last cell is focused, pressing the TAB key does nothing. If the FocusLeaveOnTab property is set to true and the last cell is focused, focus will be moved to the next control in the tab order. Similarly, if the FocusLeaveOnTab property is set to true, and the first cell is focused, pressing the SHIFT+TAB key moves focus to the previous control in the tab order.

If the UseTabKey option is set to false and the FocusLeaveOnTab property is set to true, focus is moved away from the grid control when the TAB or SHIFT+TAB key is pressed regardless of the cell being focused.

Note

The FocusLeaveOnTab option is not in effect when focus is within the New Item Row(Card).

The CTRL+TAB and CTRL+SHIFT+TAB keys allow an end-user to move focus away from the grid control. These shortcuts are in effect regardless of any other grid option settings.

See Also