次の方法で共有

InteractionTracker.TryUpdatePosition メソッド

  • リファレンス

定義

名前空間:
Windows.UI.Composition.Interactions

オーバーロード

TryUpdatePosition(Vector3, InteractionTrackerClampingOption, InteractionTrackerPositionUpdateOption)

指定したクランプ オプションを使用して 、InteractionTracker の位置の更新を試みます。
TryUpdatePosition(Vector3)

InteractionTracker の位置の更新を試みます。

TryUpdatePosition メソッドは、 InteractionTracker の位置をパラメーターとして指定された Vector3 位置に更新します。 TryUpdatePosition は、任意の時点 (開始時、状態入力イベントなど) で InteractionTracker の位置を宣言的に定義するために使用されます。 TryUpdatePosition は、Idle、CustomAnimation、または Inertia のいずれかの状態から呼び出すことができます。これにより、 InteractionTracker の位置が定義された位置に移動し、アイドル状態になります。
TryUpdatePosition(Vector3, InteractionTrackerClampingOption)

指定したクランプ オプションを使用して 、InteractionTracker の位置の更新を試みます。

TryUpdatePosition(Vector3, InteractionTrackerClampingOption, InteractionTrackerPositionUpdateOption)

編集

指定したクランプ オプションを使用して 、InteractionTracker の位置の更新を試みます。

public:
 virtual int TryUpdatePosition(float3 value, InteractionTrackerClampingOption option, InteractionTrackerPositionUpdateOption posUpdateOption) = TryUpdatePosition;
/// [Windows.Foundation.Metadata.Overload("TryUpdatePositionWithOption")]
int TryUpdatePosition(float3 const& value, InteractionTrackerClampingOption const& option, InteractionTrackerPositionUpdateOption const& posUpdateOption);
[Windows.Foundation.Metadata.Overload("TryUpdatePositionWithOption")]
public int TryUpdatePosition(Vector3 value, InteractionTrackerClampingOption option, InteractionTrackerPositionUpdateOption posUpdateOption);
function tryUpdatePosition(value, option, posUpdateOption)
Public Function TryUpdatePosition (value As Vector3, option As InteractionTrackerClampingOption, posUpdateOption As InteractionTrackerPositionUpdateOption) As Integer

パラメーター

value
Vector3 Vector3

float3

InteractionTracker の新しい位置。

option
InteractionTrackerClampingOption

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

posUpdateOption
InteractionTrackerPositionUpdateOption

既に実行されているカスタム スケール アニメーションの実行を継続できるかどうかを示す 値です。

戻り値

Int32

int

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

属性
OverloadAttribute

Windows の要件

デバイス ファミリ
Windows 10, version 2004 (10.0.19041.0 で導入)
API contract
Windows.Foundation.UniversalApiContract (v10.0 で導入)

適用対象

TryUpdatePosition(Vector3)

編集

InteractionTracker の位置の更新を試みます。

TryUpdatePosition メソッドは、 InteractionTracker の位置をパラメーターとして指定された Vector3 位置に更新します。 TryUpdatePosition は、任意の時点 (開始時、状態入力イベントなど) で InteractionTracker の位置を宣言的に定義するために使用されます。 TryUpdatePosition は、Idle、CustomAnimation、または Inertia のいずれかの状態から呼び出すことができます。これにより、 InteractionTracker の位置が定義された位置に移動し、アイドル状態になります。

public:
 virtual int TryUpdatePosition(float3 value) = TryUpdatePosition;
int TryUpdatePosition(float3 const& value);
public int TryUpdatePosition(Vector3 value);
function tryUpdatePosition(value)
Public Function TryUpdatePosition (value As Vector3) As Integer

パラメーター

value
Vector3 Vector3

float3

InteractionTracker の新しい位置。

戻り値

Int32

int

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

例

void SetupInteractionTracker()
{
  // Setup InteractionTracker
  _tracker = InteractionTracker.Create(_compositor);
  _interactionSource.PositionXSourceMode = InteractionSourceMode.EnabledWithInertia;
  _interactionSource.PositionYSourceMode = InteractionSourceMode.EnabledWithInertia;

  _tracker.InteractionSources.Add(_interactionSource);
  _tracker.PositionInertiaDecayRate = new Vector3(0.95f);

  // Update the position of InteractionTracker, so doesn’t start at (0,0)
  _tracker.TryUpdatePosition(new Vector3(50f));
}

注釈

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

現在の状態結果
アイドル要求された値に対するプロパティの更新、状態の変更なし
操作中要求が無視される
慣性要求された値に対するプロパティの更新、アイドル状態への状態の変更
CustomAnimation要求された値に対するプロパティの更新、アイドル状態への状態の変更

適用対象

TryUpdatePosition(Vector3, InteractionTrackerClampingOption)

編集

指定したクランプ オプションを使用して 、InteractionTracker の位置の更新を試みます。

public:
 virtual int TryUpdatePosition(float3 value, InteractionTrackerClampingOption option) = TryUpdatePosition;
/// [Windows.Foundation.Metadata.Overload("TryUpdatePositionWithOption")]
int TryUpdatePosition(float3 const& value, InteractionTrackerClampingOption const& option);
[Windows.Foundation.Metadata.Overload("TryUpdatePositionWithOption")]
public int TryUpdatePosition(Vector3 value, InteractionTrackerClampingOption option);
function tryUpdatePosition(value, option)
Public Function TryUpdatePosition (value As Vector3, option As InteractionTrackerClampingOption) As Integer

パラメーター

value
Vector3 Vector3

float3

InteractionTracker の新しい位置。

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 で導入)

適用対象