InteractionTracker.TryUpdatePositionBy Metodo

  • Riferimento

Definizione

Spazio dei nomi:
Windows.UI.Composition.Interactions

Overload

TryUpdatePositionBy(Vector3)

Tenta di regolare la posizione di InteractionTracker in base alla quantità specificata.

Il metodo TryUpdatePositionBy aggiorna la posizione corrente di InteractionTracker dal delta Vector3 specificato come parametro. Analogamente a TryUpdatePosition, TryUpdatePositionBy viene usato per spostare in modo dichiarativo InteractionTracker da un delta definito senza la necessità di un'animazione o di inerzia. TryUpdatePositionBy può essere chiamato dallo stato Idle, CustomAnimation o Inertia, in modo da spostare la posizione di InteractionTracker dal delta definito e immettere lo stato di inattività.
TryUpdatePositionBy(Vector3, InteractionTrackerClampingOption)

Tenta di regolare la posizione di InteractionTracker in base alla quantità specificata usando l'opzione di blocco specificata.

TryUpdatePositionBy(Vector3)

Modifica

Tenta di regolare la posizione di InteractionTracker in base alla quantità specificata.

Il metodo TryUpdatePositionBy aggiorna la posizione corrente di InteractionTracker dal delta Vector3 specificato come parametro. Analogamente a TryUpdatePosition, TryUpdatePositionBy viene usato per spostare in modo dichiarativo InteractionTracker da un delta definito senza la necessità di un'animazione o di inerzia. TryUpdatePositionBy può essere chiamato dallo stato Idle, CustomAnimation o Inertia, in modo da spostare la posizione di InteractionTracker dal delta definito e immettere lo stato di inattività.

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

Parametri

amount
Vector3 Vector3

float3

Valore da aggiungere alla posizione corrente.

Restituisce

Int32

int

Restituisce l'ID richiesta. Nelle transizioni di stato, la richiesta che ha causato la modifica dello stato verrà inclusa negli argomenti. Questi ID inizieranno da 1 e aumentano con ogni chiamata try durante la durata dell'applicazione.

Esempio

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

Commenti

Se InteractionTracker si trova nello stato di interazione (che l'utente modifica attivamente) e viene chiamato TryUpdatePositionBy, il sistema ignorerà questa richiesta: un evento viene generato quando ciò si verifica che può essere in ascolto. Se inviato da uno degli altri stati, attendere 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 correnteRisultato
IdleAggiornamenti delle proprietà al valore richiesto, nessuna modifica dello stato
InterazioneRichiesta ignorata
InerziaAggiornamenti delle proprietà al valore richiesto, modifiche dello stato in Inattività
CustomAnimationAggiornamenti delle proprietà al valore richiesto, modifiche dello stato in Inattività

Si applica a

TryUpdatePositionBy(Vector3, InteractionTrackerClampingOption)

Modifica

Tenta di regolare la posizione di InteractionTracker in base alla quantità specificata usando l'opzione di blocco specificata.

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

Parametri

amount
Vector3 Vector3

float3

Valore da aggiungere alla posizione corrente.

option
InteractionTrackerClampingOption

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

Restituisce

Int32

int

Restituisce l'ID richiesta. Nelle transizioni di stato, la richiesta che ha causato la modifica dello stato verrà inclusa negli argomenti. Questi ID inizieranno da 1 e aumentano con ogni chiamata try 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)

Si applica a