InteractionTracker.TryUpdatePositionWithAnimation 方法

定義

命名空間:

Windows.UI.Composition.Interactions

嘗試套用動畫來更新 InteractionTracker的位置。

TryUpdatePositionWithAnimation 方法會根據CompositionAnimation輸入做為參數來更新InteractionTracker的位置。 這個方法用於 互動Tracker 的動作需要由特定動畫定義，而不是傳統的慣性體驗。 TryUpdatePositionWithAnimation 可以從 Idle 或 Inertia 狀態呼叫 ，如此一來， InteractionTracker 的位置將會由定義的動畫驅動，並進入 CustomAnimation 狀態。

public:
 virtual int TryUpdatePositionWithAnimation(CompositionAnimation ^ animation) = TryUpdatePositionWithAnimation;

int TryUpdatePositionWithAnimation(CompositionAnimation const& animation);

public int TryUpdatePositionWithAnimation(CompositionAnimation animation);

function tryUpdatePositionWithAnimation(animation)

Public Function TryUpdatePositionWithAnimation (animation As CompositionAnimation) As Integer

參數

animation

CompositionAnimation

要套用至 InteractionTracker的動畫。

傳回

Int32

int

傳回要求識別碼。 在狀態轉換時，造成狀態變更的要求將會包含在引數中。 這些識別碼會從 1 開始，並在應用程式存留期期間，隨著每次嘗試呼叫而增加。

範例

void CustomAnimationForIT(Vector3 newPosition)
{
  // Create a cubic bezier easing function that will be used in the KeyFrames
  CompositionEasingFunction cubicBezier = _compositor.CreateCubicBezierEasingFunction(new Vector2(.17f, .67f), new Vector2(1f, 1f);

  // Create the Vector3 KFA
  Vector3KeyFrameAnimation kfa = _compositor.CreateVector3KeyFrameAnimation();
  kfa.Duration = TimeSpan.FromSeconds(3);

  // Create the KeyFrames
  kfa.InsertKeyFrame(1.0f, newPosition, cubicBezier);

  // Update InteractionTracker position using this animation
  _tracker.TryUpdatePositionWithAnimation(kfa);
}

備註

建立您想要更新 InteractionTracker 位置的動畫時，您不需要呼叫 StartAnimation。 一旦透過 TryUpdatePositionWithAnimation 傳入動畫，系統就會在幕後處理此動作。

定義動畫以動畫顯示 InteractionTracker 的位置時，請務必使用 Vector3KeyFrameAnimation 或解析為 Vector3 的 ExpressionAnimation 。

下表摘要說明以特定狀態呼叫此方法時的預期行為：

目前狀態	成果
閒置	要求的動畫會從要求的屬性開始，狀態變更為 CustomAnimation
Interacting	要求已忽略
慣性	要求的動畫會從要求的屬性開始，狀態變更為 CustomAnimation
CustomAnimation	目前的動畫會停止，而新的要求動畫會在要求的屬性上啟動，狀態會重新進入 CustomAnimation