InteractionTracker.TryUpdatePosition Methode

Definition

Namespace:

Windows.UI.Composition.Interactions

Ü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 Integer

Parameter

value

Vector3 Vector3

float3

Die neue Position für interactionTracker.

option

InteractionTrackerClampingOption

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

Int32

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

OverloadAttribute

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)

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 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 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

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 Integer

Parameter

value

Vector3 Vector3

float3

Die neue Position für interactionTracker.

option

InteractionTrackerClampingOption

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

Gibt zurück

Int32

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

OverloadAttribute

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)