InteractionTracker.TryUpdatePosition Metodo

Definizione

Spazio dei nomi:

Windows.UI.Composition.Interactions

Overload

TryUpdatePosition(Vector3, InteractionTrackerClampingOption, InteractionTrackerPositionUpdateOption)	Tenta di aggiornare la posizione di InteractionTracker usando l'opzione di blocco specificata.
TryUpdatePosition(Vector3)	Tenta di aggiornare la posizione di InteractionTracker. Il metodo TryUpdatePosition aggiorna la posizione di InteractionTracker alla posizione vector3 specificata come parametro. TryUpdatePosition viene usato per definire in modo dichiarativo la posizione di InteractionTracker in qualsiasi momento (all'inizio, da un evento immesso con stato e così via). TryUpdatePosition può essere chiamato dallo stato Idle, CustomAnimation o Inertia, in modo da spostare la posizione di InteractionTracker nella posizione definita e immettere lo stato inattivo.
TryUpdatePosition(Vector3, InteractionTrackerClampingOption)	Tenta di aggiornare la posizione di InteractionTracker usando l'opzione di blocco specificata.

TryUpdatePosition(Vector3, InteractionTrackerClampingOption, InteractionTrackerPositionUpdateOption)

Tenta di aggiornare la posizione di InteractionTracker usando l'opzione di blocco specificata.

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

Parametri

value

Vector3 Vector3

float3

Nuova posizione per InteractionTracker.

option

InteractionTrackerClampingOption

Valore che specifica il modo in cui i valori vengono bloccati al massimo e al minimo.

posUpdateOption

InteractionTrackerPositionUpdateOption

Valore che specifica se un'animazione di scalabilità personalizzata già in esecuzione deve essere consentita per continuare l'esecuzione.

Restituisce

Int32

int

Restituisce l'ID richiesta. Nelle transizioni di stato, la richiesta che ha causato la modifica dello stato verrà inclusa nell'args. Questi ID iniziano a 1 e aumentano con ogni chiamata di tentativo durante la durata dell'applicazione.

Attributi

OverloadAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10, version 2004 (è stato introdotto in 10.0.19041.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v10.0)

TryUpdatePosition(Vector3)

Tenta di aggiornare la posizione di InteractionTracker.

Il metodo TryUpdatePosition aggiorna la posizione di InteractionTracker alla posizione vector3 specificata come parametro. TryUpdatePosition viene usato per definire in modo dichiarativo la posizione di InteractionTracker in qualsiasi momento (all'inizio, da un evento immesso con stato e così via). TryUpdatePosition può essere chiamato dallo stato Idle, CustomAnimation o Inertia, in modo da spostare la posizione di InteractionTracker nella posizione definita e immettere lo stato inattivo.

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

Parametri

value

Vector3 Vector3

float3

Nuova posizione per InteractionTracker.

Restituisce

Int32

int

Restituisce l'ID richiesta. Nelle transizioni di stato, la richiesta che ha causato la modifica dello stato verrà inclusa nell'args. Questi ID iniziano a 1 e aumentano con ogni chiamata di tentativo durante la durata dell'applicazione.

Esempio

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));
}

Commenti

Se InteractionTracker si trova nello stato di interazione (modifica attiva dell'utente) e tryUpdatePosition viene chiamato, il sistema ignora questa richiesta: un evento viene attivato quando si verifica che può essere ascoltato. Se inviato da uno degli altri stati, ascoltare l'evento generato per IdleStateEntered e controllare la proprietà RequestId che identifica la richiesta che ha attivato il callback. La tabella seguente riepiloga il comportamento previsto quando questo metodo viene chiamato in uno stato specifico:

Stato corrente	Risultato
Idle	Aggiornamenti delle proprietà per il valore richiesto, nessuna modifica dello stato
Interazione	Richiesta ignorata
Inerzia	Aggiornamenti delle proprietà per il valore richiesto, le modifiche dello stato in Idle
CustomAnimation	Aggiornamenti delle proprietà per il valore richiesto, le modifiche dello stato in Idle

TryUpdatePosition(Vector3, InteractionTrackerClampingOption)

Tenta di aggiornare la posizione di InteractionTracker usando l'opzione di blocco specificata.

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

Parametri

value

Vector3 Vector3

float3

Nuova posizione per InteractionTracker.

option

InteractionTrackerClampingOption

Valore che specifica il modo in cui i valori vengono bloccati al massimo e al minimo.

Restituisce

Int32

int

Restituisce l'ID richiesta. Nelle transizioni di stato, la richiesta che ha causato la modifica dello stato verrà inclusa nell'args. Questi ID iniziano a 1 e aumentano con ogni chiamata di tentativo durante la durata dell'applicazione.

Attributi

OverloadAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10, version 1809 (è stato introdotto in 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v7.0)