InteractionTracker.TryUpdatePosition Methode

Definition

Überlädt

Name Beschreibung
TryUpdatePosition(Vector3, InteractionTrackerClampingOption, InteractionTrackerPositionUpdateOption)

Versucht, die Position des InteractionTracker mithilfe der angegebenen Klammeroption zu aktualisieren.

TryUpdatePosition(Vector3)

Versucht, die Position des InteractionTracker zu aktualisieren.

Die TryUpdatePosition-Methode aktualisiert die Position von InteractionTracker auf die als Parameter angegebene Vector3-Position. TryUpdatePosition wird verwendet, um die Position von InteractionTracker jederzeit deklarativ zu definieren (entweder zu Beginn, von einem Zustandsereignis usw.). TryUpdatePosition kann entweder aus dem Idle-, CustomAnimation- oder Inertia-Zustand aufgerufen werden. Dadurch wird die Position von InteractionTracker an die definierte Position verschoben und in den Leerlaufzustand eingegeben.

TryUpdatePosition(Vector3, InteractionTrackerClampingOption)

Versucht, die Position des InteractionTracker mithilfe der angegebenen Klammeroption zu aktualisieren.

TryUpdatePosition(Vector3, InteractionTrackerClampingOption, InteractionTrackerPositionUpdateOption)

Versucht, die Position des InteractionTracker mithilfe der angegebenen Klammeroption zu aktualisieren.

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

Parameter

value
Vector3 Vector3

float3

Die neue Position für InteractionTracker.

option
InteractionTrackerClampingOption

Ein Wert, der angibt, wie Werte auf das Maximum und Minimum geklemmt werden.

posUpdateOption
InteractionTrackerPositionUpdateOption

Ein Wert, der angibt, ob eine bereits ausgeführte benutzerdefinierte Skalierungsanimation weiterhin ausgeführt werden darf.

Gibt zurück

Int32

int

Gibt die Anforderungs-ID zurück. Bei Zustandsübergängen wird die Anforderung, die die Änderung des Zustands verursacht hat, in die Argen aufgenommen. Diese IDs beginnen um 1 und erhöhen sich bei jedem Try-Aufruf während der Lebensdauer der Anwendung.

Attribute

Gilt für:

TryUpdatePosition(Vector3)

Versucht, die Position des InteractionTracker zu aktualisieren.

Die TryUpdatePosition-Methode aktualisiert die Position von InteractionTracker auf die als Parameter angegebene Vector3-Position. TryUpdatePosition wird verwendet, um die Position von InteractionTracker jederzeit deklarativ zu definieren (entweder zu Beginn, von einem Zustandsereignis usw.). TryUpdatePosition kann entweder aus dem Idle-, CustomAnimation- oder Inertia-Zustand aufgerufen werden. Dadurch wird die Position von InteractionTracker an die definierte Position verschoben und in den Leerlaufzustand eingegeben.

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

Parameter

value
Vector3 Vector3

float3

Die neue Position für InteractionTracker.

Gibt zurück

Int32

int

Gibt die Anforderungs-ID zurück. Bei Zustandsübergängen wird die Anforderung, die die Änderung des Zustands verursacht hat, in die Argen aufgenommen. Diese IDs beginnen um 1 und erhöhen sich bei jedem Try-Aufruf während der Lebensdauer der Anwendung.

Beispiele

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

Hinweise

Wenn InteractionTracker sich im Interaktionszustand befindet (Benutzer aktiv bearbeiten), und TryUpdatePosition aufgerufen wird, ignoriert das System diese Anforderung – ein Ereignis wird ausgelöst, wenn dies auftritt, auf das gewartet werden kann. Wenn sie von einem der anderen Zustände gesendet wird, lauschen Sie auf das ausgelöste Ereignis auf IdleStateEntered, und überprüfen Sie die RequestId-Eigenschaft, die angibt, welche Anforderung den Rückruf ausgelöst hat. Die folgende Tabelle fasst das erwartete Verhalten zusammen, wenn diese Methode in einem bestimmten Zustand aufgerufen wird:

Aktueller Status Ergebnis
Idle Eigenschaftsaktualisierungen an den angeforderten Wert, keine Zustandsänderungen
Interaktion Anforderung ignoriert
Trägheit Eigenschaftsaktualisierungen an den angeforderten Wert, Zustandsänderungen am Leerlauf
Benutzerdefinierte Animation Eigenschaftsaktualisierungen an den angeforderten Wert, Zustandsänderungen am Leerlauf

Gilt für:

TryUpdatePosition(Vector3, InteractionTrackerClampingOption)

Versucht, die Position des InteractionTracker mithilfe der angegebenen Klammeroption zu aktualisieren.

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

Parameter

value
Vector3 Vector3

float3

Die neue Position für InteractionTracker.

option
InteractionTrackerClampingOption

Ein Wert, der angibt, wie Werte auf das Maximum und Minimum geklemmt werden.

Gibt zurück

Int32

int

Gibt die Anforderungs-ID zurück. Bei Zustandsübergängen wird die Anforderung, die die Änderung des Zustands verursacht hat, in die Argen aufgenommen. Diese IDs beginnen um 1 und erhöhen sich bei jedem Try-Aufruf während der Lebensdauer der Anwendung.

Attribute

Gilt für: