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
| TryUpdatePosition(Vector3, InteractionTrackerClampingOption, InteractionTrackerPositionUpdateOption) |
Versucht, die Position des InteractionTracker mithilfe der angegebenen Klemmoption zu aktualisieren. |
| TryUpdatePosition(Vector3) |
Versucht, die Position des InteractionTrackers zu aktualisieren. Die TryUpdatePosition-Methode aktualisiert den Speicherort von InteractionTracker auf die als Parameter angegebene Vector3-Position. TryUpdatePosition wird verwendet, um die Position von InteractionTracker zu einem beliebigen Zeitpunkt deklarativ zu definieren (entweder zu Beginn, aus einem vom Zustand eingegebenen Ereignis usw.). TryUpdatePosition kann entweder im Leerlauf-, CustomAnimation- oder Inertia-Zustand aufgerufen werden. Dadurch wird die Position von InteractionTracker an die definierte Position verschoben und in den Leerlaufzustand versetzt. |
| TryUpdatePosition(Vector3, InteractionTrackerClampingOption) |
Versucht, die Position des InteractionTracker mithilfe der angegebenen Klemmoption zu aktualisieren. |
TryUpdatePosition(Vector3, InteractionTrackerClampingOption, InteractionTrackerPositionUpdateOption)
Versucht, die Position des InteractionTracker mithilfe der angegebenen Klemmoption 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 IntegerParameter
Die neue Position für interactionTracker.
Ein Wert, der angibt, wie Werte auf das Maximum und das 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 Zustandsänderung verursacht hat, in die Argumente einbezogen. Diese IDs beginnen bei 1 und erhöhen sich mit jedem Try-Aufruf während der Lebensdauer der Anwendung.
- Attribute
Windows-Anforderungen
| Gerätefamilie |
Windows 10, version 2004 (eingeführt in 10.0.19041.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (eingeführt in v10.0)
|
Gilt für:
TryUpdatePosition(Vector3)
Versucht, die Position des InteractionTrackers zu aktualisieren.
Die TryUpdatePosition-Methode aktualisiert den Speicherort von InteractionTracker auf die als Parameter angegebene Vector3-Position. TryUpdatePosition wird verwendet, um die Position von InteractionTracker zu einem beliebigen Zeitpunkt deklarativ zu definieren (entweder zu Beginn, aus einem vom Zustand eingegebenen Ereignis usw.). TryUpdatePosition kann entweder im Leerlauf-, CustomAnimation- oder Inertia-Zustand aufgerufen werden. Dadurch wird die Position von InteractionTracker an die definierte Position verschoben und in den Leerlaufzustand versetzt.
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 IntegerParameter
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 Zustandsänderung verursacht hat, in die Argumente einbezogen. Diese IDs beginnen bei 1 und erhöhen sich mit 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 Sich InteractionTracker im interagierenden Zustand befindet (benutzerseitig aktiv manipuliert), und TryUpdatePosition aufgerufen wird, ignoriert das System diese Anforderung – ein Ereignis wird ausgelöst, wenn dies auftritt, auf das lauscht werden kann. Wenn aus einem der anderen Status gesendet wird, lauschen Sie auf das ereignis, das für IdleStateEntered ausgelöst wurde, und überprüfen Sie die RequestId-Eigenschaft, die identifiziert, 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 Zustand | Ergebnis |
|---|---|
| Idle | Eigenschaftenaktualisierungen auf den angeforderten Wert, keine Zustandsänderungen |
| Interaktion | Anforderung ignoriert |
| Trägheit | Eigenschaftenupdates für den angeforderten Wert, Zustandsänderungen im Leerlauf |
| CustomAnimation | Eigenschaftenupdates für den angeforderten Wert, Zustandsänderungen im Leerlauf |
Gilt für:
TryUpdatePosition(Vector3, InteractionTrackerClampingOption)
Versucht, die Position des InteractionTracker mithilfe der angegebenen Klemmoption 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 IntegerParameter
Die neue Position für interactionTracker.
Ein Wert, der angibt, wie Werte auf das Maximum und das Minimum geklemmt werden.
Gibt zurück
int
Gibt die Anforderungs-ID zurück. Bei Zustandsübergängen wird die Anforderung, die die Zustandsänderung verursacht hat, in die Argumente einbezogen. Diese IDs beginnen bei 1 und erhöhen sich mit jedem Try-Aufruf während der Lebensdauer der Anwendung.
- Attribute
Windows-Anforderungen
| Gerätefamilie |
Windows 10, version 1809 (eingeführt in 10.0.17763.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (eingeführt in v7.0)
|