InteractionTracker 类

定义

public ref class InteractionTracker sealed : CompositionObject

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.LiftedContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class InteractionTracker final : CompositionObject

/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.WindowsAppSDKContract, 65536)]
class InteractionTracker final : CompositionObject

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.LiftedContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class InteractionTracker : CompositionObject

[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.WindowsAppSDKContract), 65536)]
public sealed class InteractionTracker : CompositionObject

Public NotInheritable Class InteractionTracker
Inherits CompositionObject

继承

Object Platform::Object IInspectable CompositionObject InteractionTracker

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

示例

void SetupSimpleInteractionTracker(Visual viewportVisual, Visual contentVisual)
{
  //
  // Create the InteractionTracker and set its min/max position and scale.  These could 
  // also be bound to expressions.  Note: The scrollable area can be changed from either 
  // the min or the max position to facilitate content updates/virtualization.
  //

  _tracker = InteractionTracker.Create(_compositor);

  _tracker.MaxPosition = new Vector3(
    contentVisual.Size.X - viewportVisual.Size.X,
    contentVisual.Size.Y - viewportVisual.Size.Y,
    0.0f);

  _tracker.MinScale = 0.5f;
  _tracker.MaxScale = 4.0f;


  //
  // Configure the interaction source.  Enable input with inertia on all axes.
  //

  var interactionSource = VisualInteractionSource.Create(viewportVisual);

  interactionSource.PositionXSourceMode = InteractionSourceMode.EnabledWithInertia;
  interactionSource.PositionYSourceMode = InteractionSourceMode.EnabledWithInertia;
  interactionSource.ScaleSourceMode = InteractionSourceMode.EnabledWithInertia;

  _tracker.InteractionSources.Add(interactionSource);


  //
  // Bind the InteractionTracker outputs to the contentVisual.
  //

  var positionExpression = _compositor.CreateExpressionAnimation("-tracker.Position");
  positionExpression.SetReferenceParameter("tracker", _tracker);

  contentVisual.StartAnimation("Offset", positionExpression);


  var scaleExpression = _compositor.CreateExpressionAnimation("Vector3(tracker.Scale, tracker.Scale, 1.0)");

  scaleExpression.SetReferenceParameter("tracker", _tracker);

  contentVisual.StartAnimation("Scale", scaleExpression);
}

注解

InteractionTracker 是一种状态机，可以通过活动输入或显式调用来更新或对其属性进行动画处理。 InteractionTracker 类旨在启用输入以驱动 CompositionAnimation，以实现自定义交互体验。 若要构建交互式体验，必须将一个或多个 VisualInteractionSource与 InteractionTracker 相关联。

常见方案

IneractionTracker 旨在用于：

• 添加自定义轻扫行为，例如轻扫 ListView 项目或其他视觉对象以删除/消除
• 与平移绑定的转换，例如轻扫以在“已关闭”和“打开”状态之间切换
• 效果的输入驱动动画，例如平移会导致屏幕模糊
• 自定义控件，例如创建具有不同平移速度或以编程方式控制的 ScrollViewer 的自定义实现

InteractionTracker 状态和转换

InteractionTracker 是具有四种状态的状态机：

• 空闲：没有活动输入或驱动 InteractionTracker 的动画
• 交互：活动用户输入驱动 InteractionTracker
• 惯性：活动输入或编程速度产生的活动动画正在驱动 InteractionTracker
• CustomAnimation：InteractionTracker 的一个属性正在直接进行动画处理 下图显示了这四种状态以及哪些状态转换有效。

状态转换可能是由于用户操作 (（例如启动或停止操作) ）或显式调用 InteractionTracker 上的方法而导致的。 每当进行其中一个显式调用时，都会发出 requestID 以跟踪请求是否被忽略或导致状态更改。

需要注意的一个重要事项是，InteractionTracker 在与使用它的应用程序不同的进程中运行。 因此，InteractionTracker 和关联类上的所有方法调用都是异步的，通过 IInteractionTrackerOwner 接口发出的回调也是异步的。

下面描述了触发每个状态更改的原因：

InteractionTracker 进行的任何状态转换都将生成一个回调，指示新状态，其中包含与该状态相关的信息以及导致状态更改的请求的 requestID。 用户的活动操作将导致 requestID 为 0。 任何 Try* 调用都会发出 requestID，该 ID 可用于跟踪哪个 Try* 调用导致状态更改。 应用程序生存期内的第一个 requestID 将为 1，每次后续调用都会递增 requestID，这意味着每个请求 ID 都是唯一的。

InteractionTracker 位置和比例

InteractionTracker 的两个最常用的属性是位置和缩放。 每当其中一个或两个属性发生更改时，都会发送 ValuesChanged 回调，其中包含有关当前值的信息。 由于 InteractionTracker 的异步性质，通过 InteractionTracker 回调接收的值是更新针对 InteractionTracker 及其属性的当前状态和值的应用程序逻辑的最佳方式。

InteractionTracker 的一个重要区别在于其位置和比例与任何特定视觉对象的坐标空间无关。 创建 InteractionTracker 时，其位置会将矢量的 x、y 和 z 子通道设置为 0，小数位数将设置为 1。 只有活动输入或 Try* 调用会导致这些值发生更改。 每个属性的最小值和最大值将决定值可以波动的范围。 一个例外是“overpan”或“overzoom”的概念，其中活动操作可能会导致值在交互状态期间略高于最小值或最大值。 但是，当操作完成时，值将始终在设置范围内静止。 CustomAnimation 将始终固定在为位置和比例设置的范围内。

InteractionTracker 坐标空间概念与屏幕坐标的概念保持一致，即向上/向左运动会增加位置值，而向下/向右运动会降低位置值。 因此，在将位置属性附加到视觉对象的 Offset 时，通常会将其求反。

默认情况下，最小和最大位置通道均为 0，最小和最大刻度值为 1。 如果任一属性的所需行为是允许其在这些起始值之外更改，则需要更新最小值/最大值。

InteractionTracker 和 ExpressionAnimations

InteractionTracker 公开了可在 ExpressionAnimation的上下文中使用的各种属性，以推动 对 CompositionObject 的可动画属性的更新。 由于 InteractionTracker 的异步性质，不建议直接查询这些属性。 相反，应使用回调中传递的属性来驱动应用程序逻辑，并引用 ExpressionAnimation 中的值来更新可进行动画处理的属性。

如上所述，InteractionTracker 的两个最常用的属性是 Position 和 Scale 属性。 这些属性将更新以响应用户输入和 Try* 调用。 在 ExpressionAnimations 中使用这些属性将导致 CompositionObjects 的可动画处理属性在响应中更新。 例如，InteractionTracker.position 属性可以绑定到视觉对象的偏移量。 使用这些属性来填充跟踪进度的 CompositionPropertySet 也很常见，这反过来又可以驱动一系列协调动画。

将输入定向到 InteractionTracker

配置后，InteractionTracker 仍然需要最后一个步骤才能实际接收触摸输入并做出响应。 请参阅 VisualInteractionSource 上的文档。TryRedirectForManipulation 了解有关配置传入输入以流入 InteractionTracker 的详细信息。

属性

方法

适用于

另请参阅

• VisualInteractionSource
• ExpressionAnimation