次の方法で共有


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) 内を移動するために使用されます。 詳細については、「ゲームパッドとリモート コントロールの操作」を参照してください。

適用対象

こちらもご覧ください