FrameworkElement.MoveFocus Method (TraversalRequest)

 

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)

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.Boolean

Returns 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

.NET Framework
Available since 3.0
Return to top
Show: