共用方式為

InteractionTracker.TryUpdatePositionBy 方法

  • 參考

定義

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

多載

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

參數

amount
Vector3 Vector3

float3

要加入至目前位置的值。

傳回

Int32

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 處於其互動狀態 (使用者主動操作) ，而且呼叫 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

參數

amount
Vector3 Vector3

float3

要加入至目前位置的值。

option
InteractionTrackerClampingOption

值，指定值如何限制為最大值和最小值。

傳回

Int32

int

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

屬性
OverloadAttribute

Windows 需求

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

適用於