VisualInteractionSource.IsPositionYRailsEnabled 属性

定义

命名空间:

Windows.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。