Share via

FocusManager.FindNextFocusableElement Methode

  • Referenz

Definition

Namespace:
Windows.UI.Xaml.Input

Überlädt

FindNextFocusableElement(FocusNavigationDirection)

Ruft das Element ab, das den Fokus basierend auf der angegebenen Navigationsrichtung erhalten soll.
FindNextFocusableElement(FocusNavigationDirection, Rect)

Ruft das Element ab, das den Fokus basierend auf der angegebenen Navigationsrichtung und dem angegebenen Hinweisrechteck erhalten soll.

FindNextFocusableElement(FocusNavigationDirection)

Bearbeiten

Ruft das Element ab, das den Fokus basierend auf der angegebenen Navigationsrichtung erhalten soll.

public:
 static UIElement ^ FindNextFocusableElement(FocusNavigationDirection focusNavigationDirection);
/// [Windows.Foundation.Metadata.Overload("FindNextFocusableElement")]
 static UIElement FindNextFocusableElement(FocusNavigationDirection const& focusNavigationDirection);
[Windows.Foundation.Metadata.Overload("FindNextFocusableElement")]
public static UIElement FindNextFocusableElement(FocusNavigationDirection focusNavigationDirection);
function findNextFocusableElement(focusNavigationDirection)
Public Shared Function FindNextFocusableElement (focusNavigationDirection As FocusNavigationDirection) As UIElement

Parameter

focusNavigationDirection
FocusNavigationDirection

Die Richtung, in der der Fokus innerhalb der Anwendungsoberfläche von Element zu Element wechselt.

Gibt zurück

UIElement

null , wenn der Fokus nicht in der angegebenen Richtung festgelegt werden kann.

Attribute
OverloadAttribute

Hinweise

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:

FindNextFocusableElement(FocusNavigationDirection, Rect)

Bearbeiten

Ruft das Element ab, das den Fokus basierend auf der angegebenen Navigationsrichtung und dem angegebenen Hinweisrechteck erhalten soll.

public:
 static UIElement ^ FindNextFocusableElement(FocusNavigationDirection focusNavigationDirection, Rect hintRect);
/// [Windows.Foundation.Metadata.Overload("FindNextFocusableElementWithHint")]
 static UIElement FindNextFocusableElement(FocusNavigationDirection const& focusNavigationDirection, Rect const& hintRect);
[Windows.Foundation.Metadata.Overload("FindNextFocusableElementWithHint")]
public static UIElement FindNextFocusableElement(FocusNavigationDirection focusNavigationDirection, Rect hintRect);
function findNextFocusableElement(focusNavigationDirection, hintRect)
Public Shared Function FindNextFocusableElement (focusNavigationDirection As FocusNavigationDirection, hintRect As Rect) As UIElement

Parameter

focusNavigationDirection
FocusNavigationDirection

Die Richtung, in die der Fokus innerhalb der App-Benutzeroberfläche von Element zu Element wechselt.

hintRect
Rect

Ein umgebendes Rechteck, das verwendet wird, um zu beeinflussen, welches Element am wahrscheinlichsten als nächstes betrachtet wird, um den Fokus zu erhalten. Beispiele, in denen dies nützlich sein kann, sind:

  • Wenn derzeit kein Element den Fokus hat, beginnt die Angabe eines kleinen Rechtecks an der Bildschirmposition (-1, -1) den Fokus von der oberen linken Ecke des Bildschirms.
  • In einem Programmleitfaden, in dem Sie sicherstellen möchten, dass Programme zur aktuellen Zeit den Fokus erhalten. (Der Fokusalgorithmus kann Shows zu einem späteren Zeitpunkt basierend auf einer Reihe von Faktoren bevorzugen.)

Gibt zurück

UIElement

null , wenn der Fokus nicht in der angegebenen Richtung festgelegt werden kann.

Attribute
OverloadAttribute

Hinweise

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: