InteractionTracker.TryUpdatePositionBy メソッド

定義

名前空間:

Microsoft.UI.Composition.Interactions

オーバーロード

TryUpdatePositionBy(Vector3)	InteractionTracker指定した量の位置を調整しようとします。 TryUpdatePositionBy メソッドは、パラメーターとして指定された Vector3 デルタによって InteractionTracker の現在の位置を更新します。 TryUpdatePositionと同様に、TryUpdatePositionBy は、アニメーションや慣性を必要とせずに、定義済みのデルタによって InteractionTracker を宣言的に移動するために使用されます。 TryUpdatePositionBy は、アイドル状態、CustomAnimation 状態、または慣性状態から呼び出すことができます。これにより、定義されたデルタによって interactionTracker 位置が移動し、アイドル状態になります。
TryUpdatePositionBy(Vector3, InteractionTrackerClampingOption)	指定したクランプ オプションを使用して、指定した量で InteractionTracker の位置を調整しようとします。

TryUpdatePositionBy(Vector3)

InteractionTracker指定した量の位置を調整しようとします。

TryUpdatePositionBy メソッドは、パラメーターとして指定された Vector3 デルタによって InteractionTracker の現在の位置を更新します。 TryUpdatePositionと同様に、TryUpdatePositionBy は、アニメーションや慣性を必要とせずに、定義済みのデルタによって InteractionTracker を宣言的に移動するために使用されます。 TryUpdatePositionBy は、アイドル状態、CustomAnimation 状態、または慣性状態から呼び出すことができます。これにより、定義されたデルタによって interactionTracker 位置が移動し、アイドル状態になります。

public:
 virtual int TryUpdatePositionBy(float3 amount) = TryUpdatePositionBy;

int TryUpdatePositionBy(float3 const& amount);

public int TryUpdatePositionBy(Vector3 amount);

function tryUpdatePositionBy(amount)

Public Function TryUpdatePositionBy (amount As Vector3) As Integer

パラメーター

amount

Vector3 Vector3

float3

現在の位置に追加する値。

戻り値

Int32

int

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

例

public void InertiaStateEntered(InteractionTracker sender, 	InteractionTrackerInertiaStateEnteredArgs args)
{
  // For sample purpose, will overwrite Inertia motion definitions by moving InteractionTracker to a specified position based on a delta
  _tracker.TryUpdatePositionBy(new Vector3(50f));}
}

注釈

InteractionTracker が対話状態にあり (ユーザーがアクティブに操作している)、TryUpdatePositionBy が呼び出されると、システムはこの要求を無視します。この要求が発生すると、リッスン可能なイベントが発生します。 他のいずれかの状態から送信された場合は、IdleStateEntered で発生したイベントをリッスンし、コールバックをトリガーした要求を識別する RequestId プロパティを確認します。 次の表は、このメソッドが特定の状態で呼び出されたときの予想される動作をまとめたものです。

現在の状態	結果
遊休	要求された値に対するプロパティの更新、状態の変更なし
相互 作用	要求は無視されます
慣性	要求された値に対するプロパティの更新、アイドル状態への状態の変更
CustomAnimation	要求された値に対するプロパティの更新、アイドル状態への状態の変更

TryUpdatePositionBy(Vector3, InteractionTrackerClampingOption)

指定したクランプ オプションを使用して、指定した量で InteractionTracker の位置を調整しようとします。

public:
 virtual int TryUpdatePositionBy(float3 amount, InteractionTrackerClampingOption option) = TryUpdatePositionBy;

/// [Windows.Foundation.Metadata.Overload("TryUpdatePositionByWithOption")]
int TryUpdatePositionBy(float3 const& amount, InteractionTrackerClampingOption const& option);

[Windows.Foundation.Metadata.Overload("TryUpdatePositionByWithOption")]
public int TryUpdatePositionBy(Vector3 amount, InteractionTrackerClampingOption option);

function tryUpdatePositionBy(amount, option)

Public Function TryUpdatePositionBy (amount As Vector3, option As InteractionTrackerClampingOption) As Integer

パラメーター

amount

Vector3 Vector3

float3

現在の位置に追加する値。

option

InteractionTrackerClampingOption

値を最大値と最小値にクランプする方法を指定する値。

戻り値

Int32

int

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

属性

OverloadAttribute