InteractionTracker.NaturalRestingScale Eigenschaft

Definition

Namespace:

Windows.UI.Composition.Interactions

Natürliche Resting-Skalierung für den InteractionTracker.

Die NaturalRestingScale-Eigenschaft ist die berechnete Skalierungsposition, an der InteractionTracker ohne Berücksichtigung von Grenzen oder Inertia-Modifizierern zum Stillstand kommt. Diese Eigenschaft ist häufig nützlich für Aktionen wie Virtualisierung in einer Bildlaufumgebung, bei der es wichtig ist, den Speicherort zu kennen, an dem InteractionTracker beendet wird. Es gibt zwei Standard Anwendungsfälle für die Verwendung der NaturalRestingScale-Eigenschaft: Abrufen des aktuellen Werts in den InertiaStateEntered-Ereignisargumenten oder Verweisen auf diese Eigenschaft in einer ExpressionAnimation, wenn Dinge wie Inertia-Modifizierer erstellt werden.

public:
 property float NaturalRestingScale { float get(); };

float NaturalRestingScale();

public float NaturalRestingScale { get; }

var single = interactionTracker.naturalRestingScale;

Public ReadOnly Property NaturalRestingScale As Single

Eigenschaftswert

Single

float

Natürliche Resting-Skalierung für den InteractionTracker.

Beispiele

// Listen for the InertiaStateEntered event
public void InertiaStateEntered(InteractionTracker sender, 	InteractionTrackerInertiaStateEnteredArgs args)
{
  // Grab the NaturalRestingScale out of the args when the event is fired.
  float scaleRest = args.NaturalRestingScale;
}
void CreateBasicScaleSnapPoint(float maxScale, float minScale)
{
  var snappoint = InteractionTrackerInertiaRestingValue.Create(_compositor);

  // Reference the NaturalRestingScale of InteractionTracker in an ExpressionAnimation for conditional portion of an InertiaModifier.
  snappoint.Condition = _compositor.CreateExpressionAnimation("this.target.NaturalRestingScale >= min && this.target.NaturalRestingScale < max ");

  snappoint.Condition.SetScalarParameter("min", minScale);
  snappoint.Condition.SetScalarParameter("max", maxScale);

  // Snap to the highbound if condition met
  snappoint.RestingValue = _compositor.CreateExpressionAnimation("max");
  snappoint.RestingValue.SetScalarParameter("max", maxScale);

  scaleInertiaModifier.Add(snappoint);

  _tracker.ConfigureScaleInertiaModifiers(scaleInertiaModifier);
}

Hinweise

Die beiden im Codeausschnitt beschriebenen Anwendungsfälle sind die primären Verwendungen der NaturalRestingScale-Eigenschaft. Obwohl Sie möglicherweise versucht sind, auf diese Eigenschaft aus InteractionTracker wie jede andere object.property-Beziehung zu verweisen, erhalten Sie nicht immer den aktuellsten Wert. In dieser Situation wird empfohlen, auf das InertiaStateEntered-Ereignis zu lauschen und den neuesten Wert aus den Argumenten abzurufen.