FocusManager.TryMoveFocus Methode
Definition
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.
Ü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)
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); static bool TryMoveFocus(FocusNavigationDirection const& focusNavigationDirection);/// [Windows.Foundation.Metadata.Overload("TryMoveFocus")]
static bool TryMoveFocus(FocusNavigationDirection const& focusNavigationDirection);public static bool TryMoveFocus(FocusNavigationDirection focusNavigationDirection);[Windows.Foundation.Metadata.Overload("TryMoveFocus")]
public static bool TryMoveFocus(FocusNavigationDirection focusNavigationDirection);function tryMoveFocus(focusNavigationDirection)Public Shared Function TryMoveFocus (focusNavigationDirection As FocusNavigationDirection) As BooleanParameter
- focusNavigationDirection
- FocusNavigationDirection
Die Richtung für die Durchquerung (in Registerkartenreihenfolge).
Gibt zurück
bool
true , wenn der Fokus verschoben wurde; andernfalls false.
- Attribute
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 UIElement abruft, das NULL zurückgibt, wenn das nächste fokussierbare Element kein UIElement ist (z. B. ein Hyperlink-Objekt ).
Weitere Informationen
- TryMoveFocus(FocusNavigationDirection, FindNextElementOptions)
- Tastaturinteraktionen
- Fokusnavigation für Tastatur, Gamepad, Fernbedienung und Barrierefreiheitstools
- Programmgesteuerte Fokusnavigation
Gilt für:
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.
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 BooleanParameter
- 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
bool
true , wenn der Fokus verschoben wurde; andernfalls false.
- Attribute
Windows-Anforderungen
| Gerätefamilie |
Windows 10 Creators Update (eingeführt in 10.0.15063.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (eingeführt in v4.0)
|
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 UIElement abruft, das NULL zurückgibt, wenn das nächste fokussierbare Element kein UIElement ist (z. B. ein Hyperlink-Objekt ).
Weitere Informationen
- TryMoveFocus(FocusNavigationDirection)
- Tastaturinteraktionen
- Fokusnavigation für Tastatur, Gamepad, Fernbedienung und Barrierefreiheitstools
- Programmgesteuerte Fokusnavigation