InteractionTracker.TryUpdatePosition Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ü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
Die neue Position für InteractionTracker.
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
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
Die neue Position für InteractionTracker.
Gibt zurück
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
Die neue Position für InteractionTracker.
Ein Wert, der angibt, wie Werte auf das Maximum und Minimum geklemmt werden.
Gibt zurück
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