FocusManager.TryMoveFocus Methode

  • Referenz

Definition

Namespace:
Microsoft.UI.Xaml.Input

Überlädt

TryMoveFocus(FocusNavigationDirection)

Versucht, den Fokus vom Element mit Fokus auf das nächste fokussierbare Element in der angegebenen Richtung zu ändern.
TryMoveFocus(FocusNavigationDirection, FindNextElementOptions)

Versucht, den Fokus vom Element mit Fokus auf das nächste fokussierbare Element in der angegebenen Richtung zu ändern, indem die angegebenen Navigationsoptionen verwendet werden.

TryMoveFocus(FocusNavigationDirection)

Bearbeiten

Versucht, den Fokus vom Element mit Fokus auf das nächste fokussierbare Element in der angegebenen Richtung zu ändern.

public:
 static bool TryMoveFocus(FocusNavigationDirection focusNavigationDirection);
/// [Windows.Foundation.Metadata.Overload("TryMoveFocus")]
 static bool TryMoveFocus(FocusNavigationDirection const& focusNavigationDirection);
[Windows.Foundation.Metadata.Overload("TryMoveFocus")]
public static bool TryMoveFocus(FocusNavigationDirection focusNavigationDirection);
function tryMoveFocus(focusNavigationDirection)
Public Shared Function TryMoveFocus (focusNavigationDirection As FocusNavigationDirection) As Boolean

Parameter

focusNavigationDirection
FocusNavigationDirection

Die Richtung für die Durchquerung (in Registerkartenreihenfolge).

Gibt zurück

Boolean

bool

true wenn der Fokus verschoben wurde; falseandernfalls .

Attribute
OverloadAttribute

Hinweise

Die Tabulatorreihenfolge ist die Reihenfolge, in der ein Benutzer von einem Steuerelement zum anderen wechselt, indem er die TAB-TASTE (vorwärts) oder UMSCHALT+TAB (rückwärts) drückt.

Diese Methode verwendet die Reihenfolge und das Verhalten der Registerkartenreihenfolge, um alle fokussierbaren Elemente auf der Benutzeroberfläche zu durchlaufen.

  • Wenn der Fokus auf das erste Element in der Registerkartenreihenfolge und FocusNavigationDirection.Previous angegeben ist, wird der Fokus auf das letzte Element verschoben.
  • Wenn der Fokus auf das letzte Element in der Registerkartenreihenfolge und FocusNavigationDirection.Next festgelegt ist, wird der Fokus auf das erste Element verschoben.

Sie können auch die FindNextElement(FocusNavigationDirection, FindNextElementOptions)- Methode oder die FindNextElement(FocusNavigationDirection) -Methode verwenden, um den Fokus programmgesteuert zu verschieben. Diese Methoden rufen das -Element (als DependencyObject) ab, das den Fokus basierend auf der angegebenen Navigationsrichtung erhält (nur die Richtungsnavigation kann nicht verwendet werden, um die Registerkartennavigation zu emulieren).

Hinweis

Es wird empfohlen, die FindNextElement-Methode anstelle von FindNextFocusableElement zu verwenden, da FindNextFocusableElement ein UIElementabgerufen wird, das zurückgibt null , wenn das nächste fokussierbare Element nicht ein UIElement ist (z. B. ein Hyperlink-Objekt ).

Weitere Informationen

Gilt für:

TryMoveFocus(FocusNavigationDirection, FindNextElementOptions)

Bearbeiten

Versucht, den Fokus vom Element mit Fokus auf das nächste fokussierbare Element in der angegebenen Richtung zu ändern, indem die angegebenen Navigationsoptionen verwendet werden.

public:
 static bool TryMoveFocus(FocusNavigationDirection focusNavigationDirection, FindNextElementOptions ^ focusNavigationOptions);
/// [Windows.Foundation.Metadata.Overload("TryMoveFocusWithOptions")]
 static bool TryMoveFocus(FocusNavigationDirection const& focusNavigationDirection, FindNextElementOptions const& focusNavigationOptions);
[Windows.Foundation.Metadata.Overload("TryMoveFocusWithOptions")]
public static bool TryMoveFocus(FocusNavigationDirection focusNavigationDirection, FindNextElementOptions focusNavigationOptions);
function tryMoveFocus(focusNavigationDirection, focusNavigationOptions)
Public Shared Function TryMoveFocus (focusNavigationDirection As FocusNavigationDirection, focusNavigationOptions As FindNextElementOptions) As Boolean

Parameter

focusNavigationDirection
FocusNavigationDirection

Die Richtung für die Durchquerung (in Registerkartenreihenfolge).

focusNavigationOptions
FindNextElementOptions

Die Optionen, um das nächste Element zu identifizieren, das den Fokus mit Tastatur/Controller/Remotenavigation erhalten soll.

Gibt zurück

Boolean

bool

true wenn der Fokus verschoben wurde; falseandernfalls .

Attribute
OverloadAttribute

Hinweise

Die Tabulatorreihenfolge ist die Reihenfolge, in der ein Benutzer von einem Steuerelement zum anderen wechselt, indem er die TAB-TASTE (vorwärts) oder UMSCHALT+TAB (rückwärts) drückt.

Diese Methode verwendet die Reihenfolge und das Verhalten der Registerkartenreihenfolge, um alle fokussierbaren Elemente auf der Benutzeroberfläche zu durchlaufen.

  • Wenn der Fokus auf das erste Element in der Registerkartenreihenfolge und FocusNavigationDirection.Previous angegeben ist, wird der Fokus auf das letzte Element verschoben.
  • Wenn der Fokus auf das letzte Element in der Registerkartenreihenfolge und FocusNavigationDirection.Next festgelegt ist, wird der Fokus auf das erste Element verschoben.

Sie können auch die FindNextElement(FocusNavigationDirection, FindNextElementOptions)- Methode oder die FindNextElement(FocusNavigationDirection) -Methode verwenden, um den Fokus programmgesteuert zu verschieben. Diese Methoden rufen das -Element (als DependencyObject) ab, das den Fokus basierend auf der angegebenen Navigationsrichtung erhält (nur die Richtungsnavigation kann nicht verwendet werden, um die Registerkartennavigation zu emulieren).

Hinweis

Es wird empfohlen, die FindNextElement-Methode anstelle von FindNextFocusableElement zu verwenden, da FindNextFocusableElement ein UIElementabgerufen wird, das zurückgibt null , wenn das nächste fokussierbare Element nicht ein UIElement ist (z. B. ein Hyperlink-Objekt ).

Weitere Informationen

Gilt für: