Back to Devexpress

Navigating Through Nodes and Cells

windowsforms-998-controls-and-libraries-tree-list-end-user-capabilities-navigating-through-nodes-and-cells.md

latest3.7 KB
Original Source

Navigating Through Nodes and Cells

  • Oct 17, 2024
  • 3 minutes to read

The keyboard shortcuts and mouse operations listed in this topic can be used by end users to move node and column focus.

Common Navigation Operations

The following table contains common navigation operations that are available to end users:

ActionEffect
Clicking a data cellMoves focus to the clicked cell.
Clicking a node’s indicator cellMoves focus to the corresponding row and preserves column focus.
DOWN ARROWMoves focus to the next node and preserves column focus.
UP ARROWMoves focus to the previous node and preserves column focus.
RIGHT ARROWMoves focus to the next cell within the focused node. If the TreeListOptionsNavigation.AutoMoveRowFocus option is enabled and the last node cell is focused, the Right Arrow key moves focus to the first cell within the next node. If the TreeListOptionsNavigation.AllowExpandCollapseWithArrowKeys property is enabled and the first cell in a collapsed node is focused, the Right Arrow key expands the node.
LEFT ARROWMoves focus to the previous cell within the focused node. If the TreeListOptionsNavigation.AutoMoveRowFocus option is enabled and the first node cell is focused, the Left Arrow key moves focus to the last cell within the previous node. If the TreeListOptionsNavigation.AllowExpandCollapseWithArrowKeys property is enabled and the first cell in an expanded node is focused, the Left Arrow key collapses the node.
TABIf the TreeListOptionsNavigation.UseTabKey option is active, moves focus to the next cell within the focused node. If the TreeListOptionsNavigation.AutoMoveRowFocus option is also enabled and the last node cell is focused, this key moves focus to the first cell within the next node.
CONTROL+TABMoves focus away from the Tree List to the next control according to the tab order.
SHIFT+TABIf the TreeListOptionsNavigation.UseTabKey option is active, moves focus to the previous cell within the focused node. If the TreeListOptionsNavigation.AutoMoveRowFocus option is also enabled and the first node cell is focused, this key combination moves focus to the last cell within the previous node.
ENTERIf a user is editing a cell and the TreeListOptionsNavigation.EnterMovesNextColumn option is enabled, Enter moves focus to the next cell within the current node and invokes the focused cell’s editor.
HOMEMoves focus to the first cell within the focused node.
ENDMoves focus to the last cell within the focused node.
PAGE DOWNMoves node focus down one page and preserves column focus.
PAGE UPMoves node focus up one page and preserves column focus.
CTRL+HOMEMoves focus to the first cell within the first node.
CTRL+ENDMoves focus to the last cell within the last node.

Notes :

  • When a user navigates with the Ctrl key pressed, focus movement does not affect selection.