OptionsFocus.MoveFocusDirection Property

Gets or sets the direction in which focus moves in Automatic Tab Order mode when the TAB key is pressed.

Namespace: DevExpress.XtraLayout

Assembly: DevExpress.XtraLayout.v19.1.dll

Declaration

C#

[DefaultValue(MoveFocusDirection.AcrossThenDown)]
[XtraSerializableProperty]
public MoveFocusDirection MoveFocusDirection { get; set; }

VB.NET

<DefaultValue(MoveFocusDirection.AcrossThenDown)>
<XtraSerializableProperty>
Public Property MoveFocusDirection As MoveFocusDirection

Property Value

Type	Default	Description
MoveFocusDirection	**AcrossThenDown**	A MoveFocusDirection value that specifies the direction in which focus moves.

Available values:

Name	Description
AcrossThenDown	Focus moves from one ‘row’ to another selecting each control in a row.
DownThenAcross	Focus moves from one ‘column’ to another selecting each control in a column

Property Paths

You can access this nested property as listed below:

Object Type	Path to MoveFocusDirection
DataLayoutControl	.OptionsFocus.MoveFocusDirection
LayoutControl	.OptionsFocus.MoveFocusDirection

Remarks

The Automatic Tab Order feature is enabled if the OptionsFocus.EnableAutoTabOrder property is set to true. In this mode, pressing the TAB key moves focus between controls according to the settings specified by the MoveFocusDirection and OptionsFocus.MoveFocusRightToLeft properties.

If the MoveFocusDirection property is set to MoveFocusDirection.AcrossThenDown, focus moves from one ‘row’ to another selecting each control in a row. If this option is set to MoveFocusDirection.DownThenAcross, focus moves from one ‘column’ to another selecting each control in a column.

See the Focus Management topic for more information.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the MoveFocusDirection property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-change-the-tab-order-within-the-layoutview-e1476/CS/S131978/Form1.cs#L18

    productsBindingSource.DataSource = GetProductsDataTable();
    ((ILayoutControl)layoutView1).OptionsFocus.MoveFocusDirection = MoveFocusDirection.DownThenAcross;
}

VB.NET

how-to-change-the-tab-order-within-the-layoutview-e1476/VB/S131978/Form1.vb#L16

    productsBindingSource.DataSource = GetProductsDataTable()
    CType(layoutView1, ILayoutControl).OptionsFocus.MoveFocusDirection = MoveFocusDirection.DownThenAcross
End Sub