FrameworkElement.MoveFocus(TraversalRequest) Methode

Definition

Namespace:
System.Windows
Assembly:
PresentationFramework.dll

Verschiebt den Tastaturfokus von diesem Element und auf ein anderes Element in einer bereitgestellten Durchquerungsrichtung.

public:
 override bool MoveFocus(System::Windows::Input::TraversalRequest ^ request);
public override sealed bool MoveFocus(System.Windows.Input.TraversalRequest request);
override this.MoveFocus : System.Windows.Input.TraversalRequest -> bool
Public Overrides NotOverridable Function MoveFocus (request As TraversalRequest) As Boolean

Parameter

request
TraversalRequest

Die Richtung, in die der Fokus verschoben werden soll, als Wert der Enumeration.

Gibt zurück

Boolean

Gibt zurück true , wenn der Fokus erfolgreich verschoben wird. false Wenn das Zielelement in richtungsweise nicht vorhanden ist oder nicht tastaturorientiert sein konnte.

Beispiele

Im folgenden Beispiel wird ein Handler implementiert, der mehrere mögliche Schaltflächeneingaben behandelt. Jede Schaltfläche stellt eine mögliche FocusNavigationDirectiondar. Der Handler verfolgt das Element mit dem aktuellen Tastaturfokus und ruft dieses Element auf MoveFocus , indem er die entsprechende FocusNavigationDirection Initialisierung für den TraversalRequest bereitgestellten Typparameter angibt.

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

' 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

Hinweise

Diese Implementierung setzt die Methode außer Kraft UIElement.MoveFocus und versiegelt sie.

Gilt für:

Weitere Informationen