InteractionTracker.TryUpdatePosition 方法

定義

命名空間:

Windows.UI.Composition.Interactions

多載

TryUpdatePosition(Vector3, InteractionTrackerClampingOption, InteractionTrackerPositionUpdateOption)	嘗試使用指定的固定選項來更新 InteractionTracker 的位置。
TryUpdatePosition(Vector3)	嘗試更新 InteractionTracker的位置。 TryUpdatePosition 方法會將 InteractionTracker 的位置更新為指定為參數的 Vector3 位置。 TryUpdatePosition 可用來宣告方式定義 InteractionTracker 在任何時間點的位置， (一開始、從某些狀態輸入的事件等等 ) 。 TryUpdatePosition 可以從 Idle、CustomAnimation 或慣性狀態呼叫 – 這麼做會將 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

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

屬性

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 或慣性狀態呼叫 – 這麼做會將 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

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

範例

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 處於其 Interactioning State (使用者主動操作) ，且呼叫 TryUpdatePosition，系統將會忽略此要求 – 當發生這種情況時可接聽的事件就會引發。 如果從其中一個其他狀態傳送，請接聽針對 IdleStateEntered 引發的事件，並檢查 RequestId 屬性，以識別觸發回呼的要求。 下表摘要說明當這個方法在特定狀態下呼叫時的預期行為：

目前狀態	成果
閒置	要求值的屬性更新，沒有狀態變更
Interacting	忽略要求
慣性	要求值的屬性更新，狀態變更為 Idle
CustomAnimation	要求值的屬性更新，狀態變更為 Idle

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

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

屬性

OverloadAttribute

Windows 需求

裝置系列	Windows 10, version 1809 (已於 10.0.17763.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v7.0 引進)