InteractionTracker.NaturalRestingScale プロパティ

定義

名前空間:

Windows.UI.Composition.Interactions

InteractionTracker の自然な休止スケール。

NaturalRestingScale プロパティは、境界や慣性修飾子を計算せずに InteractionTracker が停止する計算されたスケール位置です。 このプロパティは、多くの場合、スクロール エクスペリエンスでの仮想化などのアクションに役立ちます。 InteractionTracker が停止する場所を知ることが重要です。 NaturalRestingScale プロパティを使用するには、2 つのメインユース ケースがあります。InertiaStateEntered イベント引数で現在の値を取得するか、慣性修飾子などを作成するときに ExpressionAnimation でこのプロパティを参照します。

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

float NaturalRestingScale();

public float NaturalRestingScale { get; }

var single = interactionTracker.naturalRestingScale;

Public ReadOnly Property NaturalRestingScale As Single

プロパティ値

Single

float

InteractionTracker の自然な休止スケール。

例

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

注釈

コード スニペットで説明されている 2 つのユース ケースは、NaturalRestingScale プロパティの主な用途です。 他の object.property リレーションシップと同様に InteractionTracker からこのプロパティを参照したくなるかもしれませんが、常に最新の値が取得されるとは限りません。 この状況では、 InertiaStateEntered イベントをリッスンし、引数から最新の値を取得することをお勧めします。