XYFocusNavigationStrategy Перечисление

Определение

Указывает стратегию неоднозначности, используемую для навигации между несколькими целевыми объектами-кандидатами с помощью XYFocusDownNavigationStrategy, XYFocusLeftNavigationStrategy, XYFocusRightNavigationStrategy и XYFocusUpNavigationStrategy.

Примечание

Другие факторы, такие как ранее сфокусированный элемент или близость к оси направления навигации, могут повлиять на конечный результат навигации.

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
Наследование
XYFocusNavigationStrategy
Атрибуты

Поля

Auto 0

Указывает, что стратегия навигации наследуется от предков элемента. Если все предки имеют значение Auto, резервная стратегия имеет значение Projection.

NavigationDirectionDistance 2

Указывает, что фокус перемещается на элемент, ближайший к оси направления навигации.

Край ограничивающей прямоугольника, соответствующий направлению навигации , расширяется и проецируется для определения потенциальных целевых объектов. Первый обнаруженный элемент считается целевым. При наличии нескольких кандидатов целевым элементом становится самый ближний из них. Если кандидатов по-прежнему несколько, кандидатом становится самый верхний и самый левый элемент.

Навигация фокуса — расстояние

Фокус перемещается вниз от A к C, а затем от C к B

Projection 1

Указывает, что фокус перемещается на первый элемент, возникший при проецировке края текущего элемента в направлении навигации.

Навигация фокуса — проекция

Фокус перемещается с A к D вниз на основе проекции нижнего края A

RectilinearDistance 3

Указывает, что фокус перемещается к ближайшему элементу на основе кратчайшего двухD-расстояния (метрика Манхэттена).

Это расстояние рассчитывается путем сложения основного и дополнительного расстояния каждого потенциального кандидата. В случае с галстуком:

  • Первый элемент слева выбирается, если направление навигации вверх или вниз
  • Первый элемент в верхней части выбирается, если направление навигации влево или вправо

Здесь мы покажем, как фокус перемещается от A к B на основе прямолинейного расстояния.

  • Расстояние (A, B, вниз) = 10 + 0 = 10
  • Расстояние (A, C, вниз) = 0 + 30 = 30
  • Расстояние (A, D, вниз) 30 + 0 = 30
Навигация фокуса — прямоугольная дистанция

Фокус перемещается из A в B на основе прямолинейного расстояния

Комментарии

Навигация по XY используется для навигации по пользовательскому интерфейсу с помощью игрового контроллера или стрелки направления клавиатуры. Дополнительные сведения см. в разделе Взаимодействие с геймпадом и удаленным управлением.

Применяется к

См. также раздел