Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Diagrams
  [Expand]Gauges
  [Expand]Map Control
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Collapse]Form Layout Managers
    Side Panel
   [Collapse]Layout Manager
    [Expand]Product Information
    [Expand]Getting Started
    [Expand]Layout Control
    [Expand]Data Layout Control
    [Expand]Layout Item
    [Expand]Layout Groups
    [Expand]Tabbed Group
    [Expand]Other Layout Elements
    [Expand]Customization Capabilities
    [Expand]Size and Alignment
     Flow Layout
     Table Layout
     Focus Management
    [Expand]Appearance and Look and Feel
    [Expand]Miscellaneous
    [Expand]Examples
    [Expand]Member Tables
   [Expand]Tabbed MDI Manager
    Tab Control
   [Expand]Wizard Control
    Workspace Manager
  [Expand]Navigation Controls
  [Expand]Printing-Exporting
  [Expand]PDF Viewer
   Reporting
  [Expand]Snap
  [Expand]TreeMap Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Focus Management

An end-user can move focus between layout items using the TAB key and shortcuts.

By default, the Layout Control's Automatic Tab Order feature is enabled and the tab order defined by the TabIndex properties of the controls that constitute the layout is ignored. In this mode the layout control tracks the TAB key being pressed and moves focus according to its settings. When the Layout Control receives focus the top-, leftmost control is focused. When the TAB key is pressed focus is moved across and then down. So consistent focus movement is supported by default according to the visual order of the controls.

Shortcuts that can be added for layout items allow an end-user to quickly jump to a specific control. To specify a shortcut add the ampersand ('&') before a specific character in the layout item's label (the BaseLayoutItem.Text property). An end-user can then press this character while holding the ALT key down to move focus to this layout item's control.

Expanded Using Automatic Tab Order

The options that enable you to specify the sequence in which the controls are selected when an end-user presses the TAB key can be accessed via the layout control's LayoutControl.OptionsFocus property. These options are described below in detail.

  • OptionsFocus.EnableAutoTabOrder

    This is the main option which enables the layout control's Automatic Tab Order feature. If this option is set to false, the sequence in which the controls are selected when an end-user presses the TAB key is controlled by the form. For more information on how to set the tab order on Windows Forms, see "Setting the Tab Order on Windows Forms" concept in MSDN.

  • OptionsFocus.AllowFocusControlOnActivatedTabPage

    This option controls whether the top-left control is automatically focused after the tabbed page has been activated.

  • OptionsFocus.MoveFocusDirection

    This option specifies the direction in which the controls are selected when an end-user presses the TAB key. If it's set to "AcrossThenDown", the focus moves from one 'row' to another selecting each control in a row.

    If this option is set to "DownThenAcross", the focus moves from one 'column' to another selecting each control in a column.

  • OptionsFocus.MoveFocusRightToLeft

    This option specifies the horizontal direction in which controls are selected when an end-user presses the TAB key. By default, this option is set to false. In this instance, controls are selected from left to right when an end-user presses the TAB key. Pressing the SHIFT+TAB keys moves the focus from right to left.

    Otherwise, if set to true, the direction in which controls are selected is inverted. In this instance, controls are selected from right to left when using the TAB key and, alternatively, from left to right if the SHIFT+TAB keys are used.

Expanded See Also

How would you rate this topic?​​​​​​​