VisualInteractionSource.IsPositionYRailsEnabled プロパティ

定義

名前空間:

Microsoft.UI.Composition.Interactions

y 軸のパンが手すりになっているかどうかを示します。

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

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

bool IsPositionYRailsEnabled();

void IsPositionYRailsEnabled(bool value);

public bool IsPositionYRailsEnabled { get; set; }

var boolean = visualInteractionSource.isPositionYRailsEnabled;
visualInteractionSource.isPositionYRailsEnabled = boolean;

Public Property IsPositionYRailsEnabled As Boolean

プロパティ値

Boolean

bool

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

例

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

注釈

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

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

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

注意

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