VisualInteractionSource.IsPositionXRailsEnabled 属性

定义

命名空间:

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