FrameworkElement.MoveFocus(TraversalRequest) Methode

Referenz

Definition

Namespace:: System.Windows

Assembly:: PresentationFramework.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Verschiebt den Tastaturfokus von diesem Element in einer angegebenen Durchlaufrichtung zu einem anderen Element.

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 true zurück, wenn der Fokus erfolgreich verschoben wurde. false wird zurückgegeben, wenn das Zielelement in der angegebenen Richtung nicht vorhanden ist oder den Tastaturfokus nicht erhalten kann.

Beispiele

Im folgenden Beispiel wird ein Handler implementiert, der mehrere mögliche Schaltflächeneingaben verarbeitet. Jede Schaltfläche stellt eine mögliche FocusNavigationDirectiondar. Der Handler verfolgt das Element mit dem aktuellen Tastaturfokus nach und ruft MoveFocus dieses Element auf, indem er das entsprechende FocusNavigationDirection als Initialisierung für den TraversalRequest angegebenen 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

Durch diese Implementierung wird die Methode außer Kraft gesetzt UIElement.MoveFocus und versiegelt.

Gilt für:

Produkt	Versionen
.NET Framework	3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

Freigeben über