InteractionTracker.TryUpdatePositionBy Methode

Definition

Namespace:

Windows.UI.Composition.Interactions

Überlädt

TryUpdatePositionBy(Vector3)

Versucht, die Position des InteractionTrackers um den angegebenen Betrag anzupassen. Die TryUpdatePositionBy-Methode aktualisiert den aktuellen Speicherort von InteractionTracker durch das als Parameter angegebene Vector3-Delta. Ähnlich wie TryUpdatePosition Wird TryUpdatePositionBy verwendet, um InteractionTracker deklarativ um ein definiertes Delta zu verschieben, ohne dass eine Animation oder Einträgheit erforderlich ist. TryUpdatePositionBy kann entweder im Leerlauf-, CustomAnimation- oder Inertia-Zustand aufgerufen werden. Dadurch wird die Position von InteractionTracker durch das definierte Delta verschoben und in den Leerlaufzustand versetzt.

TryUpdatePositionBy(Vector3, InteractionTrackerClampingOption)

Versucht, die Position des InteractionTrackers mithilfe der angegebenen Klemmoption um den angegebenen Betrag anzupassen.

TryUpdatePositionBy(Vector3)

Versucht, die Position des InteractionTrackers um den angegebenen Betrag anzupassen.

Die TryUpdatePositionBy-Methode aktualisiert den aktuellen Speicherort von InteractionTracker durch das als Parameter angegebene Vector3-Delta. Ähnlich wie TryUpdatePosition Wird TryUpdatePositionBy verwendet, um InteractionTracker deklarativ um ein definiertes Delta zu verschieben, ohne dass eine Animation oder Einträgheit erforderlich ist. TryUpdatePositionBy kann entweder im Leerlauf-, CustomAnimation- oder Inertia-Zustand aufgerufen werden. Dadurch wird die Position von InteractionTracker durch das definierte Delta verschoben und in den Leerlaufzustand versetzt.

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

Parameter

amount

Vector3 Vector3

float3

Der Wert, der der aktuellen Position hinzugefügt werden soll.

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

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

Hinweise

Wenn InteractionTracker sich im interagierenden Zustand befindet (benutzerseitig aktiv manipuliert), und TryUpdatePositionBy 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

TryUpdatePositionBy(Vector3, InteractionTrackerClampingOption)

Versucht, die Position des InteractionTrackers mithilfe der angegebenen Klemmoption um den angegebenen Betrag anzupassen.

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

Parameter

amount

Vector3 Vector3

float3

Der Wert, der der aktuellen Position hinzugefügt werden soll.

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)