Freigeben über


FocusManager.TryMoveFocus Methode

Definition

Ü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 Boolean

Parameter

focusNavigationDirection
FocusNavigationDirection

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

Gibt zurück

Boolean

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

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 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; 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

Gilt für: