InteractionTracker.TryUpdatePositionBy メソッド

定義

名前空間:

Windows.UI.Composition.Interactions

オーバーロード

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

TryUpdatePositionBy(Vector3)

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

TryUpdatePositionBy メソッドは、パラメーターとして指定された Vector3 デルタによって InteractionTracker の現在の位置を更新します。 TryUpdatePosition と同様に、TryUpdatePositionBy は、アニメーションや慣性を必要とせずに、定義されたデルタによって InteractionTracker を宣言的に移動するために使用されます。 TryUpdatePositionBy は、Idle、CustomAnimation、または Inertia のいずれかの状態から呼び出すことができます。これにより、定義されたデルタによって 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 から開始され、アプリケーションの有効期間中に各 try 呼び出しで増加します。

例

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 が Interacting State (ユーザーがアクティブに操作) していて、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 から開始され、アプリケーションの有効期間中に各 try 呼び出しで増加します。

属性

OverloadAttribute

Windows の要件

デバイス ファミリ	Windows 10, version 1809 (10.0.17763.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v7.0 で導入)