InteractionTracker.TryUpdatePositionBy 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| TryUpdatePositionBy(Vector3) |
嘗試依指定的數量調整 InteractionTracker的位置。 TryUpdatePositionBy 方法會依指定為參數的 Vector3 差異來更新 InteractionTracker 的目前位置。 與 TryUpdatePosition 類似，TryUpdatePositionBy是用來以宣告方式移動 InteractionTracker ，而不需要動畫或慣性。 TryUpdatePositionBy 可以從 Idle、CustomAnimation 或慣性狀態呼叫 – 這麼做會依定義的差異移動 InteractionTracker 的位置，並進入閒置狀態。 |
| TryUpdatePositionBy(Vector3, InteractionTrackerClampingOption) |
嘗試使用指定的限制選項，依指定的數量調整 InteractionTracker 的位置。 |
TryUpdatePositionBy(Vector3)
嘗試依指定的數量調整 InteractionTracker的位置。
TryUpdatePositionBy 方法會依指定為參數的 Vector3 差異來更新 InteractionTracker 的目前位置。 與 TryUpdatePosition 類似，TryUpdatePositionBy是用來以宣告方式移動 InteractionTracker ，而不需要動畫或慣性。 TryUpdatePositionBy 可以從 Idle、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參數
傳回
int
傳回要求識別碼。 在狀態轉換上，造成狀態變更的要求將會包含在引數中。 這些識別碼會在 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 處於其 Interactioning State (使用者主動操作) ，且呼叫 TryUpdatePositionBy，系統將會忽略此要求 – 當發生可接聽的情況時，就會引發事件。 如果從其中一個其他狀態傳送，請接聽針對 IdleStateEntered 引發的事件，並檢查 RequestId 屬性，以識別觸發回呼的要求。 下表摘要說明當這個方法在特定狀態下呼叫時的預期行為：
| 目前狀態 | 成果 |
|---|---|
| 閒置 | 要求值的屬性更新，沒有狀態變更 |
| Interacting | 忽略要求 |
| 慣性 | 要求值的屬性更新，狀態變更為 Idle |
| CustomAnimation | 要求值的屬性更新，狀態變更為 Idle |
適用於
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參數
值，指定值如何限制在最大值和最小值。
傳回
int
傳回要求識別碼。 在狀態轉換上，造成狀態變更的要求將會包含在引數中。 這些識別碼會在 1 開始，並在應用程式的存留期期間，隨著每次嘗試呼叫而增加。
- 屬性