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 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 UIElementParameter
- focusNavigationDirection
- FocusNavigationDirection
Die Richtung, in die der Fokus von Element zu Element innerhalb der Anwendungs-UI verschoben wird.
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 direktionale Navigation kann nicht zum Emulieren der Registerkartennavigation verwendet werden).
Anmerkung
Es wird empfohlen, die FindNextElement- Methode anstelle von FindNextFocusableElement zu verwenden, da FindNextFocusableElement eine UIElementabruft, die 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 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 UIElementParameter
- focusNavigationDirection
- FocusNavigationDirection
Die Richtung, in die der Fokus von Element zu Element innerhalb der App-Benutzeroberfläche verschoben wird.
- hintRect
- Rect
Ein umgebendes Rechteck, das verwendet wird, um zu beeinflussen, welches Element am ehesten als nächstes betrachtet wird, um den Fokus zu erhalten. Beispiele, in denen dies hilfreich sein kann, sind:
- Wenn derzeit kein Element den Fokus hat, beginnt die Angabe eines kleinen Rechtecks an einer Bildschirmposition von (-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 zu einem späteren Zeitpunkt basierend auf einer Reihe von Faktoren angezeigt werden.)
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 direktionale Navigation kann nicht zum Emulieren der Registerkartennavigation verwendet werden).
Anmerkung
Es wird empfohlen, die FindNextElement- Methode anstelle von FindNextFocusableElement zu verwenden, da FindNextFocusableElement eine UIElementabruft, die 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