Freigeben über

XYFocusNavigationStrategyOverride Enumeration

  • Referenz

Definition

Namespace:
Microsoft.UI.Xaml.Input
Bearbeiten

Gibt an, wie das XAML-Framework das Ziel einer XY-Navigation bestimmt.

Überschreibt XYFocusKeyboardNavigationStrategyMode.

public enum class XYFocusNavigationStrategyOverride
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
enum class XYFocusNavigationStrategyOverride
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
public enum XYFocusNavigationStrategyOverride
Public Enum XYFocusNavigationStrategyOverride
Vererbung
Enum
XYFocusNavigationStrategyOverride
Attribute
ContractVersionAttribute

Felder

Auto 1

Gibt an, dass die Navigationsstrategie von den Vorgängern des Elements geerbt wird. Wenn alle Vorgänger den Wert haben Auto, lautet Projectiondie Fallbackstrategie .
NavigationDirectionDistance 3

Gibt an, dass der Fokus auf das Element verschoben wird, das der Achse der Navigationsrichtung am nächsten kommt.

Der Rand des begrenzungsenden Rechtecks, das der Navigationsrichtung entspricht, wird erweitert und projiziert, um potenzielle Ziele zu identifizieren. Das erste gefundene Element wird als Ziel identifiziert. Bei mehreren Kandidaten wird das nächstgelegene Element als Ziel identifiziert. Wenn noch mehrere Kandidaten vorhanden sind, wird das oberste/am weitesten links stehende Element als Kandidat identifiziert.

Fokusnavigation – Entfernung

Der Fokus wechselt von A nach C und dann von C nach B bei der Navigation nach unten
None 0

Es wird keine Navigationsüberschreibung angewendet.
Projection 2

Gibt an, dass der Fokus auf das erste Element verschoben wird, das beim Projizieren des Rands des aktuell fokussierten Elements in Richtung der Navigation gefunden wurde.

Hinweis

Andere Faktoren, z. B. das zuvor fokussierte Element und die Nähe zur Achse der Navigationsrichtung, können das Ergebnis beeinflussen.

Fokusnavigation – Projektion

Der Fokus bewegt sich von A nach D bei der Navigation nach unten, basierend auf der Projektion des unteren Rands von A
RectilinearDistance 4

Gibt an, dass der Fokus basierend auf dem kürzesten 2D-Abstand (Manhattan-Metrik) auf das nächstgelegene Element verschoben wird.

Diese Entfernung wird berechnet, indem die primäre Entfernung und die sekundäre Entfernung jedes potenziellen Kandidaten addiert werden. Im Falle eines Unentschiedens:

  • Das erste Element links wird ausgewählt, wenn die Navigationsrichtung nach oben oder unten lautet.
  • Das erste Element oben wird ausgewählt, wenn die Navigationsrichtung links oder rechts ist.

Hier zeigen wir, wie sich der Fokus basierend auf der rektilinearen Entfernung von A nach B bewegt.

  • Entfernung (A, B, Nach unten) = 10 + 0 = 10
  • Abstand (A, C, Nach unten) = 0 + 30 = 30
  • Abstand (A, D, Nach unten) 30 + 0 = 30
Fokusnavigation – geradlinige Entfernung

Der Fokus wechselt von A nach B basierend auf der geradlinigen Entfernung

Hinweise

Die XY-Navigation wird verwendet, um auf einer Benutzeroberfläche (UI) mit einem Gamecontroller oder richtungsgerichteten Tastaturpfeilen zu navigieren. Weitere Informationen finden Sie unter Gamepad- und Remotesteuerungsinteraktionen.

Gilt für:

Weitere Informationen