InteractionTracker.TryUpdatePosition Methode

Definition

Namespace:

Microsoft.UI.Composition.Interactions

Überlädt

TryUpdatePosition(Vector3, InteractionTrackerClampingOption, InteractionTrackerPositionUpdateOption)	Versucht, die Position des InteractionTracker mithilfe der angegebenen Klammeroption zu aktualisieren.
TryUpdatePosition(Vector3)	Versucht, die Position des InteractionTrackerzu aktualisieren. Die TryUpdatePosition-Methode aktualisiert den Speicherort InteractionTracker- auf die als Parameter angegebene Vector3-Position. TryUpdatePosition wird verwendet, um die Position von InteractionTracker zu einem beliebigen Zeitpunkt (entweder zu Beginn, von einem Zustand eingegebenen Ereignis usw.) deklarativ zu definieren. TryUpdatePosition kann entweder aus dem Idle-, CustomAnimation- oder Inertia-Zustand aufgerufen werden. Dadurch wird die Position 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

value

Vector3 Vector3

float3

Die neue Position für die InteractionTracker-.

option

InteractionTrackerClampingOption

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

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

TryUpdatePosition(Vector3)

Versucht, die Position des InteractionTrackerzu aktualisieren.

Die TryUpdatePosition-Methode aktualisiert den Speicherort InteractionTracker- auf die als Parameter angegebene Vector3-Position. TryUpdatePosition wird verwendet, um die Position von InteractionTracker zu einem beliebigen Zeitpunkt (entweder zu Beginn, von einem Zustand eingegebenen Ereignis usw.) deklarativ zu definieren. TryUpdatePosition kann entweder aus dem Idle-, CustomAnimation- oder Inertia-Zustand aufgerufen werden. Dadurch wird die Position 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

value

Vector3 Vector3

float3

Die neue Position für die InteractionTracker-.

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

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 in seinem Interaktionszustand befindet (Benutzer aktiv bearbeiten), und TryUpdatePosition wird diese Anforderung ignoriert, ein Ereignis wird ausgelöst, wenn dies auftritt, das überwacht 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

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

value

Vector3 Vector3

float3

Die neue Position für die InteractionTracker-.

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