XYFocusNavigationStrategy 列挙型

定義

XYFocusDownNavigationStrategy、XYFocusLeftNavigationStrategy、XYFocusRightNavigationStrategyXYFocusUpNavigationStrategy を使用して複数の候補ターゲット間を移動するために使用されるあいまいさを解消する方法を指定します。

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

フィールド

名前 説明
Auto 0

ナビゲーション戦略が要素の先祖から継承されることを示します。 すべての先祖の値が Auto の場合、フォールバック戦略は Projection

Projection 1

現在フォーカスされている要素の端をナビゲーションの方向に投影するときに発生した最初の要素にフォーカスが移動することを示します。

フォーカス ナビゲーション - プロジェクション

A の下端の投影に基づいて、下のナビゲーションでフォーカスが A から D に移動する

NavigationDirectionDistance 2

ナビゲーション方向の軸に最も近い要素にフォーカスが移動することを示します。

ナビゲーション方向に対応する境界 rect のエッジが 拡張 され、候補ターゲットを識別するように 投影されます 。 最初に検出された要素がターゲットとして識別されます。 複数の候補がある場合、最も近い要素がターゲットとして識別されます。 複数の候補が存在する場合は、最上位/左端の要素が候補として識別されます。

フォーカス ナビゲーション - 距離

フォーカスが A から C に、次に下のナビゲーションで C から B に移動する

RectilinearDistance 3

最短の 2D 距離 (マンハッタン メトリック) に基づいて、最も近い要素にフォーカスが移動することを示します。

この距離は、各候補の 1 次距離と 2 次距離を加算することによって計算されます。 タイの場合:

  • ナビゲーションの方向が上下の場合は、左側の最初の要素が選択されます
  • ナビゲーションの方向が左または右の場合、上部の最初の要素が選択されます

ここでは、直線距離に基づいてフォーカスが A から B に移動する方法を示します。

  • 距離 (A、B、Down) = 10 + 0 = 10
  • Distance (A,C, Down) = 0 + 30 = 30
  • 距離 (A、D、下) 30 + 0 = 30
フォーカス ナビゲーション - 直線距離

直線距離に基づいてフォーカスが A から B に移動する

注釈

XY ナビゲーションは、ゲーム コントローラーまたはキーボード方向矢印を使用してユーザー インターフェイス (UI) 内を移動するために使用されます。 詳細については、ゲームパッドとリモート コントロールの操作に関するページを参照してください。

適用対象

こちらもご覧ください