InteractionTracker.TryUpdateScaleWithAdditionalVelocity メソッド

定義

名前空間:

Microsoft.UI.Composition.Interactions

指定した速度を追加してスケールの更新を試みます。

TryUpdateScaleWithAdditionalVelocity メソッドは、 InteractionTracker の現在の速度に追加の速度を表す入力スカラーを追加し、中心点を入力された Vector3 にシフトします。 その結果、 InteractionTracker の速度が変更されたため、 InteractionTracker の対象となる rest スケールの位置が変更されるようになりました。 TryUpdateScaleWithAdditionalVelocity は、アイドル状態、慣性状態、または CustomAnimation 状態から呼び出すことができます。これにより、InteractionTracker の速度が追加または更新され、慣性状態になります。

public:
 virtual int TryUpdateScaleWithAdditionalVelocity(float velocityInPercentPerSecond, float3 centerPoint) = TryUpdateScaleWithAdditionalVelocity;

int TryUpdateScaleWithAdditionalVelocity(float const& velocityInPercentPerSecond, float3 const& centerPoint);

public int TryUpdateScaleWithAdditionalVelocity(float velocityInPercentPerSecond, Vector3 centerPoint);

function tryUpdateScaleWithAdditionalVelocity(velocityInPercentPerSecond, centerPoint)

Public Function TryUpdateScaleWithAdditionalVelocity (velocityInPercentPerSecond As Single, centerPoint As Vector3) As Integer

パラメーター

velocityInPercentPerSecond

Single

float

スケールに追加する速度。

centerPoint

Vector3 Vector3

float3

新しい中心点。

戻り値

Int32

int

要求 ID を返します。 状態遷移では、状態の変化の原因となった要求が args に含まれます。 これらの ID は 1 から開始され、アプリケーションの有効期間中に各 try 呼び出しで増加します。

例

// Listen for the InertiaStateEntered event
public void InertiaStateEntered(InteractionTracker sender, 	InteractionTrackerInertiaStateEnteredArgs args)
{
  // Adding velocity to InteractionTracker if condition met
  if (_extraVelocityNeeded)
  {
    // Adding velocity to the scale motion.
    _tracker.TryUpdateScaleWithAdditionalVelocity(3.0f, new Vector3(75f));
  }
}

注釈

InteractionTracker が対話状態 (ユーザーがアクティブに操作している) にあり、TryUpdateScaleWithAdditionalVelocity が呼び出されると、システムはこの要求を無視します。この要求が発生すると、リッスンできるイベントが発生します。 他のいずれかの状態から送信された場合は、InertiaStateEntered に対して発生したイベントをリッスンし、コールバックをトリガーした要求を識別する RequestId プロパティをチェックします。

次の表は、このメソッドが特定の状態で呼び出されたときの予想される動作をまとめたものです。

現在の状態	結果
アイドル	慣性および慣性修飾子に対する状態の変化は、要求された速度を初期速度として評価します
操作中	要求が無視される
慣性	慣性が再起動され(状態が慣性に再入する)、慣性修飾子は現在の速度に加えられた要求された速度で評価されます
CustomAnimation	要求された速度を初期速度として使用して評価された慣性修飾子を使用して、現在のアニメーションが停止し、慣性状態が変化する