다음을 통해 공유


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의 아래쪽 가장자리 투영에 따라 아래쪽 탐색에서 포커스가 A에서 D로 이동합니다.

RectilinearDistance 3

가장 짧은 2D 거리(맨해튼 메트릭)에 따라 포커스가 가장 가까운 요소로 이동했음을 나타냅니다.

이 거리는 각 잠재적 후보의 기본 거리와 보조 거리를 추가하여 계산됩니다. 넥타이의 경우:

  • 탐색 방향이 위쪽 또는 아래쪽인 경우 왼쪽의 첫 번째 요소가 선택됩니다.
  • 탐색 방향이 왼쪽 또는 오른쪽인 경우 맨 위에 있는 첫 번째 요소가 선택됩니다.

여기서는 직사각형 거리에 따라 포커스가 A에서 B로 이동하는 방법을 보여줍니다.

  • 거리(A, B, 아래쪽) = 10 + 0 = 10
  • 거리(A, C, 아래쪽) = 0 + 30 = 30
  • 거리(A, D, 아래쪽) 30 + 0 = 30
포커스 탐색 - 직사각형 거리

직사각형 거리에 따라 포커스가 A에서 B로 이동합니다.

설명

XY 탐색은 게임 컨트롤러 또는 키보드 방향 화살표를 사용하여 UI(사용자 인터페이스)를 탐색하는 데 사용됩니다. 자세한 내용은 게임 패드 및 원격 제어 상호 작용을 참조하세요.

적용 대상

추가 정보