共用方式為

XYFocusNavigationStrategy 列舉

  • 參考

定義

命名空間:
Microsoft.UI.Xaml.Input
編輯

指定使用 XYFocusDownNavigationStrategy、 XYFocusLeftNavigationStrategy、 XYFocusRightNavigationStrategy、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
繼承
Enum
XYFocusNavigationStrategy
屬性
ContractVersionAttribute

欄位

Auto 0

表示流覽策略繼承自元素的祖系。 如果所有上階都有 的值 Auto ，則後援策略為 Projection 。
NavigationDirectionDistance 2

表示焦點移至最接近導覽方向座標軸的專案。

對應至導覽方向的周框矩形邊緣會 延伸 並 投影 以識別候選目標。 系統會將碰到的第一個元素視為目標。 如果有多個候選項目，則會將最靠近的元素視為目標。 如果仍有多個候選項目，則會將最上方/最左邊的元素視為候選項目。

焦點流覽 - 距離

向下瀏覽時焦點從 A 移到 C，再從 C 移到 B。
Projection 1

表示焦點移至在導覽方向投影目前焦點專案邊緣時所遇到的第一個專案。

焦點流覽 - 投影

焦點會根據 A 底緣的投影在向下瀏覽時從 A 移動 D
RectilinearDistance 3

指出焦點會根據最短的 2D 距離移至最接近的元素， () 。

這個距離的計算方式是將每個潛在的候選項目主要距離和次要距離相加。 在系結的情況下：

  • 如果導覽方向是向上或向下，則會選取左側的第一個專案
  • 如果流覽方向為左或向右，則會選取頂端的第一個專案

我們在這裡示範焦點如何根據直線距離從 A 移至 B。

  • Distance (A, B, Down) = 10 + 0 = 10
  • Distance (A, C, Down) = 0 + 30 = 30
  • Distance (A, D, Down) 30 + 0 = 30
焦點流覽 - 直線距離

焦點會根據直線距離從 A 移至 B

備註

XY 流覽可用來使用遊戲控制器或鍵盤方向箭號來流覽使用者介面 (UI) 。 如需詳細資訊，請參閱 遊戲台和遠端控制互動

適用於

另請參閱