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

Определение

Указывает, как платформа XAML определяет целевой объект навигации XY.

Переопределяет XYFocusKeyboardNavigationStrategyMode.

public enum class XYFocusNavigationStrategyOverride
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 262144)]
enum class XYFocusNavigationStrategyOverride
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 262144)]
public enum XYFocusNavigationStrategyOverride
Public Enum XYFocusNavigationStrategyOverride
Наследование
XYFocusNavigationStrategyOverride
Атрибуты

Требования к Windows

Семейство устройств
Windows 10 Creators Update (появилось в 10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (появилось в v4.0)

Поля

Auto 1

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

NavigationDirectionDistance 3

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

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

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

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

None 0

Переопределение навигации не применяется.

Projection 2

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

Примечание

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

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

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

RectilinearDistance 4

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

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

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

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

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

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

Комментарии

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

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

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