VisualInteractionSource.IsPositionXRailsEnabled プロパティ

定義

名前空間:

Microsoft.UI.Composition.Interactions

x 軸のパンを手すりにするかどうかを示します。

IsPositionXRailsEnabled プロパティは、X 軸パンが対応する InteractionTracker に送信される場合の手すりの構成を定義します。 有効にすると、パンの最初の部分が X 軸に対して特定の範囲内で角度付けされている場合、パンの Y コンポーネントは無視され、完全な水平パンと見なされます。 このプロパティは、多くの場合、X と Y の両方のスクロール エクスペリエンスが有効になっているが、信頼性の高い完璧な水平パンが必要な場合に有効になります。

public:
 property bool IsPositionXRailsEnabled { bool get(); void set(bool value); };

bool IsPositionXRailsEnabled();

void IsPositionXRailsEnabled(bool value);

public bool IsPositionXRailsEnabled { get; set; }

var boolean = visualInteractionSource.isPositionXRailsEnabled;
visualInteractionSource.isPositionXRailsEnabled = boolean;

Public Property IsPositionXRailsEnabled As Boolean

プロパティ値

Boolean

bool

x 軸のパンが手すりになっているかどうかを示すブール値。

例

void SetupInteractionSource(ContainerVisual container, InteractionTracker 	tracker)
{
  // Setup the InteractionSource
  _interactionSource = VisualInteractionSource.Create(container);
  // Enable the property for rails on the X axis being enabled
  _interactionSource.IsPositionXRailsEnabled = true;
  // Add the InteractionSource to the InteractionTracker
  tracker.InteractionSources.Add(_interactionSource);
}

注釈

このプロパティを有効にすると、システムは"完璧な" 水平パンと見なされるものの読み取りを向上します。 多くの場合、指が画面全体をパンするとき、エンド ユーザーが X 方向に完璧なパンを実現することは非常に困難です。 このプロパティを使用すると、X パンと Y パンの両方が既に有効になっているシナリオ (多方向スクロールなど) で"完璧な" 水平パンを行えるのに役立ちます。

有効にすると、水平軸の 22.5 度以内のパンは"完璧な" 水平パンとして認識されます。つまり、Y コンポーネントは無視されます。 パンの角度は相互作用の最初の数ミリメートル以内に決定され、指が持ち上げられるまでその角度を保持します。 軸のしきい値が 22.5 度を超える場合、Y コンポーネントが認識されます。

次の図は、これを視覚的な形式で示しています。

注意

レールが有効になっている場合、これはチェーンに影響します。 パンが軸の 22.5 度以内にある場合にのみ、システムは最も近い acenstor VisualInteractionSource までチェーンされます。