語言

XYFocusNavigationStrategy 列舉

定義

指定使用 XYFocusDownNavigationStrategy、 XYFocusLeftNavigationStrategy、 XYFocusRightNavigationStrategy 及 XYFocusUpNavigationStrategy 在多個候選目標間導航的消歧策略。

Note

其他因素,如先前聚焦的元素或與導航方向軸線的接近程度,也會影響導航的最終結果。

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
屬性

欄位

名稱 值 Description
Auto 0

表示導航策略是從元素的祖先繼承而來。 若所有祖先值均為 Auto,則備用策略為 Projection。

Projection 1

表示焦點會移至當前聚焦元素邊緣投射到導航方向時遇到的第一個元素。

對焦導航-投影

根據A底緣的投影,對焦從A移動到D。

NavigationDirectionDistance 2

表示焦點會移至最接近導航方向軸的元素。

對應導航方向的邊界矩形邊緣會 被延伸 並 投影 ,以識別候選目標。 第一個遇到的元素即為目標。 若有多個候選元素,則以最接近的元素作為目標。 若仍有多個候選,則最頂端/最左邊的元素即為候選。

對焦導航 - 距離

對焦在下行導航時從A移到C,再從C移到B。

RectilinearDistance 3

表示焦點會根據最短的二維距離(曼哈頓度量)移向最近的元素。

此距離是將每位潛在候選人的主距離與次要距離相加計算得出。 若出現平手:

  • 如果導航方向是向上或向下,則選擇左側第一個元素
  • 如果導航方向是左或右,則會選擇通往頂端的第一個元素

這裡我們展示了焦點如何根據直線距離從A移動到B。

  • 距離(A, B, Down)= 10 + 0 = 10
  • 距離 (A, C, Down) = 0 + 30 = 30
  • 距離(A、D、下)30 + 0 = 30
對焦導航 - 直線距離

焦點會根據直線距離從A移動到B。

備註

XY 導航用於透過遊戲控制器或鍵盤方向箭頭來導航使用者介面(UI)。 更多資訊請參見 遊戲手把與遙控器的互動

適用於

另請參閱