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
| Name | Beschreibung |
|---|---|
| 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 mithilfe der angegebenen Navigationsoptionen zu ändern. |
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);
/// [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 zum Durchlaufen (in Aktivierreihenfolge).
Gibt zurück
bool
truewenn der Fokus verschoben wurde; andernfalls . false
- Attribute
Hinweise
Die Aktivierreihenfolge ist die Reihenfolge, in der ein Benutzer von einem Steuerelement zu einem anderen wechselt, indem er die TAB-TASTE (vorwärts) oder UMSCHALT+TAB (rückwärts) drückt.
Diese Methode verwendet die Aktivierreihenfolge und das Verhalten, um alle fokussierbaren Elemente in der Benutzeroberfläche zu durchlaufen.
- Wenn sich der Fokus auf dem ersten Element in der Aktivierreihenfolge befindet und FocusNavigationDirection.Previous angegeben ist, wird der Fokus auf das letzte Element verschoben.
- Wenn sich der Fokus auf dem letzten Element in der Aktivierreihenfolge befindet und FocusNavigationDirection.Next angegeben 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 direktionale Navigation kann nicht zum Emulieren der Registerkartennavigation verwendet werden).
Hinweis
Es wird empfohlen, die FindNextElement-Methode zu verwenden, anstatt FindNextFocusableElementFindNextFocusableElement ein UIElementObjekt abzurufen, das zurückgibt null , wenn das nächste fokussierbare Element kein UIElement (z. B. ein Hyperlink-Objekt ) ist.
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 mithilfe der angegebenen Navigationsoptionen zu ändern.
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 zum Durchlaufen (in Aktivierreihenfolge).
- focusNavigationOptions
- FindNextElementOptions
Die Optionen zum Identifizieren des nächsten Elements, das den Fokus mit Tastatur/Controller/Remotenavigation erhalten soll.
Gibt zurück
bool
truewenn der Fokus verschoben wurde; andernfalls . false
- Attribute
Hinweise
Die Aktivierreihenfolge ist die Reihenfolge, in der ein Benutzer von einem Steuerelement zu einem anderen wechselt, indem er die TAB-TASTE (vorwärts) oder UMSCHALT+TAB (rückwärts) drückt.
Diese Methode verwendet die Aktivierreihenfolge und das Verhalten, um alle fokussierbaren Elemente in der Benutzeroberfläche zu durchlaufen.
- Wenn sich der Fokus auf dem ersten Element in der Aktivierreihenfolge befindet und FocusNavigationDirection.Previous angegeben ist, wird der Fokus auf das letzte Element verschoben.
- Wenn sich der Fokus auf dem letzten Element in der Aktivierreihenfolge befindet und FocusNavigationDirection.Next angegeben 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 direktionale Navigation kann nicht zum Emulieren der Registerkartennavigation verwendet werden).
Hinweis
Es wird empfohlen, die FindNextElement-Methode zu verwenden, anstatt FindNextFocusableElementFindNextFocusableElement ein UIElementObjekt abzurufen, das zurückgibt null , wenn das nächste fokussierbare Element kein UIElement (z. B. ein Hyperlink-Objekt ) ist.
Weitere Informationen
- TryMoveFocus(FocusNavigationDirection)
- Tastaturinteraktionen
- Fokusnavigation für Tastatur, Gamepad, Fernbedienung und Barrierefreiheitstools
- Programmgesteuerte Fokusnavigation