FrameworkElement.MoveFocus Method
Moves the keyboard focus away from this element and to another element in a provided traversal direction.
Namespace: System.Windows
Assembly: PresentationFramework (in PresentationFramework.dll)
Parameters
- request
- Type: System.Windows.Input.TraversalRequest
The direction that focus is to be moved, as a value of the enumeration.
Return Value
Type: System.BooleanReturns true if focus is moved successfully; false if the target element in direction as specified does not exist or could not be keyboard focused.
This implementation overrides UIElement.MoveFocus and seals the method.
The following example implements a handler that handles several possible button inputs. Each button represents a possible FocusNavigationDirection. The handler tracks the element with current keyboard focus, and calls MoveFocus on that element, by specifying the appropriate FocusNavigationDirection as initialization for the TraversalRequest type parameter provided.
// Creating a FocusNavigationDirection object and setting it to a // local field that contains the direction selected. FocusNavigationDirection focusDirection = _focusMoveValue; // MoveFocus takes a TraveralReqest as its argument. TraversalRequest request = new TraversalRequest(focusDirection); // Gets the element with keyboard focus. UIElement elementWithFocus = Keyboard.FocusedElement as UIElement; // Change keyboard focus. if (elementWithFocus != null) { elementWithFocus.MoveFocus(request); }
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
