FrameworkElement.MoveFocus Method (TraversalRequest)
Moves the keyboard focus away from this element and to another element in a provided traversal direction.
Assembly: PresentationFramework (in PresentationFramework.dll)
Public Overrides NotOverridable Function MoveFocus ( request As TraversalRequest ) As Boolean
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. Dim focusDirection As FocusNavigationDirection = _focusMoveValue ' MoveFocus takes a TraveralReqest as its argument. Dim request As New TraversalRequest(focusDirection) ' Gets the element with keyboard focus. Dim elementWithFocus As UIElement = TryCast(Keyboard.FocusedElement, UIElement) ' Change keyboard focus. If elementWithFocus IsNot Nothing Then elementWithFocus.MoveFocus(request) End If
Available since 3.0