共用方式為


InteractionTracker.TryUpdatePosition 方法

定義

多載

TryUpdatePosition(Vector3, InteractionTrackerClampingOption, InteractionTrackerPositionUpdateOption)

嘗試使用指定的固定選項來更新 InteractionTracker 的位置。

TryUpdatePosition(Vector3)

嘗試更新 interactionTracker位置

TryUpdatePosition 方法會將 interactionTracker 的位置更新為指定為參數的 Vector3 位置。 TryUpdatePosition 可用來以宣告方式定義任何時間點 InteractionTracker 的位置(從某個狀態輸入的事件開始等等)。 TryUpdatePosition 可以從 Idle、CustomAnimation 或慣性狀態呼叫 – 這麼做會將 InteractionTra cker 的位置移至定義的位置並進入閑置狀態。

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

參數

option
InteractionTrackerClampingOption

值,指定值如何限製為最大值和最小值。

posUpdateOption
InteractionTrackerPositionUpdateOption

值,指定是否應該允許已經執行的自定義縮放動畫繼續執行。

傳回

Int32

int

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

屬性

適用於

TryUpdatePosition(Vector3)

嘗試更新 interactionTracker位置

TryUpdatePosition 方法會將 interactionTracker 的位置更新為指定為參數的 Vector3 位置。 TryUpdatePosition 可用來以宣告方式定義任何時間點 InteractionTracker 的位置(從某個狀態輸入的事件開始等等)。 TryUpdatePosition 可以從 Idle、CustomAnimation 或慣性狀態呼叫 – 這麼做會將 InteractionTra cker 的位置移至定義的位置並進入閑置狀態。

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

參數

傳回

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

目前狀態結果
要求值的屬性更新,沒有狀態變更
交互忽略要求
慣性對要求值的屬性更新、狀態變更為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

參數

option
InteractionTrackerClampingOption

值,指定值如何限製為最大值和最小值。

傳回

Int32

int

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

屬性

適用於