InteractionTracker.TryUpdatePositionBy Methode

Definition

Namespace:

Microsoft.UI.Composition.Interactions

Überlädt

TryUpdatePositionBy(Vector3)

Versucht, den InteractionTrackerPosition um den angegebenen Betrag anzupassen. Die TryUpdatePositionBy-Methode aktualisiert den aktuellen Speicherort von InteractionTracker durch das vector3-Delta, das als Parameter angegeben wurde. Ähnlich wie TryUpdatePositionwird TryUpdatePositionBy verwendet, um InteractionTracker durch ein definiertes Delta deklarativ zu verschieben, ohne dass eine Animation oder Inertia erforderlich ist. TryUpdatePositionBy kann entweder aus dem Status "Idle", "CustomAnimation" oder "Inertia" aufgerufen werden. Dadurch wird die Position InteractionTracker durch das definierte Delta verschoben und in den Leerlaufzustand eingegeben.

TryUpdatePositionBy(Vector3, InteractionTrackerClampingOption)

Versucht, die Position des InteractionTracker durch den angegebenen Betrag mithilfe der angegebenen Klammeroption anzupassen.

TryUpdatePositionBy(Vector3)

Versucht, den InteractionTrackerPosition um den angegebenen Betrag anzupassen.

Die TryUpdatePositionBy-Methode aktualisiert den aktuellen Speicherort von InteractionTracker durch das vector3-Delta, das als Parameter angegeben wurde. Ähnlich wie TryUpdatePositionwird TryUpdatePositionBy verwendet, um InteractionTracker durch ein definiertes Delta deklarativ zu verschieben, ohne dass eine Animation oder Inertia erforderlich ist. TryUpdatePositionBy kann entweder aus dem Status "Idle", "CustomAnimation" oder "Inertia" aufgerufen werden. Dadurch wird die Position InteractionTracker durch das definierte Delta verschoben und in den Leerlaufzustand eingegeben.

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

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 Interaktionszustand befindet (Benutzer aktiv bearbeiten), und TryUpdatePositionBy aufgerufen wird, ignoriert das System diese Anforderung – ein Ereignis wird ausgelöst, wenn dies auftritt, auf das lauscht 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 Zustand	Ergebnis
Untätig	Eigenschaftsaktualisierungen an den angeforderten Wert, keine Zustandsänderungen
Aufeinander wirkend	Anforderung ignoriert
Trägheit	Eigenschaftsaktualisierungen an den angeforderten Wert, Zustandsänderungen am Leerlauf
CustomAnimation	Eigenschaftsaktualisierungen an den angeforderten Wert, Zustandsänderungen am Leerlauf

TryUpdatePositionBy(Vector3, InteractionTrackerClampingOption)

Versucht, die Position des InteractionTracker durch den angegebenen Betrag mithilfe der angegebenen Klammeroption 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 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

OverloadAttribute