次の方法で共有


XYFocusNavigationStrategyOverride 列挙型

定義

XAML フレームワークが XY ナビゲーションのターゲットを決定する方法を指定します。

XYFocusKeyboardNavigationStrategyMode をオーバーライドします。

public enum class XYFocusNavigationStrategyOverride
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
enum class XYFocusNavigationStrategyOverride
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
public enum XYFocusNavigationStrategyOverride
Public Enum XYFocusNavigationStrategyOverride
継承
XYFocusNavigationStrategyOverride
属性

フィールド

Auto 1

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

NavigationDirectionDistance 3

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

ナビゲーション方向に対応する境界の四角形の端が拡張、プロジェクションされて、ターゲット候補を識別します。 最初に接触した要素がターゲットとして識別されます。 複数の候補がある場合は、最も近い要素がターゲットとして識別されます。 さらに複数の候補がある場合には、最も上で最も左の要素が候補として識別されます。

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

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

None 0

ナビゲーションオーバーライドは適用されません。

Projection 2

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

注意

前にフォーカスがあった要素や、ナビゲーション方向の軸までの近さなど、アルゴリズムに影響を与えるその他の要因により、結果に影響があります。

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

A の下端のプロジェクションに基づき、下ナビゲーションでフォーカスを A から D へ移動します。

RectilinearDistance 4

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

この距離は、潜在的な各候補のプライマリ距離とセカンダリ距離を加算することによって計算されます。 同点の場合:

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

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

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

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

注釈

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

適用対象

こちらもご覧ください