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 度以内时，系统才会链接到最接近的 VisualInteractionSource。