InteractionTracker.TryUpdatePosition 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| 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參數
InteractionTracker的新位置。
值，指定值如何限制在最大值和最小值。
- posUpdateOption
- InteractionTrackerPositionUpdateOption
值，指定是否應該允許已經執行的自訂縮放動畫繼續執行。
傳回
int
傳回要求識別碼。 在狀態轉換上，造成狀態變更的要求將會包含在引數中。 這些識別碼會在 1 開始，並在應用程式的存留期期間，隨著每次嘗試呼叫而增加。
- 屬性
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參數
InteractionTracker的新位置。
傳回
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參數
InteractionTracker的新位置。
值，指定值如何限制在最大值和最小值。
傳回
int
傳回要求識別碼。 在狀態轉換上，造成狀態變更的要求將會包含在引數中。 這些識別碼會在 1 開始，並在應用程式的存留期期間，隨著每次嘗試呼叫而增加。
- 屬性
Windows 需求
| 裝置系列 |
Windows 10, version 1809 (已於 10.0.17763.0 引進)
|
| API contract |
Windows.Foundation.UniversalApiContract (已於 v7.0 引進)
|