Export (0) Print
Expand All

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)

public override sealed bool MoveFocus(
	TraversalRequest request
)

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.
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);
}

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft