Прочитать на английском

Поделиться через


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

Определение

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

Примечание

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

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

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

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

Поля

Auto 0

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

NavigationDirectionDistance 2

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

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

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

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

Projection 1

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

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

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

RectilinearDistance 3

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

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

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

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

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

Перемещение фокуса из A в B на основе прямой дистанции

Комментарии

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

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

Продукт Версии
WinRT Build 15063, Build 16299, Build 17134, Build 17763, Build 18362, Build 19041, Build 20348, Build 22000, Build 22621, Build 26100

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