Freigeben über


XYFocusNavigationStrategy Enumeration

Definition

Gibt die Mehrdeutigkeitsstrategie an, die für die Navigation zwischen mehreren Kandidatenzielen mithilfe von XYFocusDownNavigationStrategy, XYFocusLeftNavigationStrategy, XYFocusRightNavigationStrategy und XYFocusUpNavigationStrategy verwendet wird.

Hinweis

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

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

Felder

Auto 0

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 2

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

Der Rand des begrenzungsenden Rekts, der der Navigationsrichtung entspricht, wird erweitert und projiziert , um Kandidatenziele 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/linke Element als Kandidat identifiziert.

Fokusnavigation – Entfernung

Der Fokus wechselt von A nach C und dann von C nach B in der Navigation nach unten

Projection 1

Gibt an, dass der Fokus auf das erste Element verschoben wird, das beim Projizieren der Kante des aktuell fokussierten Elements in Navigationsrichtung gefunden wird.

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 3

Gibt an, dass der Fokus basierend auf der kürzesten 2D-Entfernung (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 hinzugefügt werden. Bei Gleichstand:

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

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

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

Der Fokus bewegt sich basierend auf der geradlinigen Entfernung von A nach B

Hinweise

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

Gilt für:

Weitere Informationen