FocusManager.FindNextFocusableElement 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
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)
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
null , wenn der Fokus nicht in der angegebenen Richtung festgelegt werden kann.
- Attribute
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
- FindNextFocusableElement(FocusNavigationDirection, Rect)
- Tastaturinteraktionen
- Fokusnavigation für Tastatur, Gamepad, Fernbedienung und Barrierefreiheitstools
- Programmgesteuerte Fokusnavigation
Gilt für:
FindNextFocusableElement(FocusNavigationDirection, Rect)
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
null , wenn der Fokus nicht in der angegebenen Richtung festgelegt werden kann.
- Attribute
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
- FindNextFocusableElement(FocusNavigationDirection)
- Tastaturinteraktionen
- Fokusnavigation für Tastatur, Gamepad, Fernbedienung und Barrierefreiheitstools
- Programmgesteuerte Fokusnavigation