VisualInteractionSource クラス

定義

[WebHostHidden]
public ref class VisualInteractionSource : CompositionObject, ICompositionInteractionSource

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.LiftedContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[WebHostHidden]
class VisualInteractionSource : CompositionObject, ICompositionInteractionSource

/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.WindowsAppSDKContract, 65536)]
[WebHostHidden]
class VisualInteractionSource : CompositionObject, ICompositionInteractionSource

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.LiftedContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class VisualInteractionSource : CompositionObject, ICompositionInteractionSource

[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.WindowsAppSDKContract), 65536)]
public class VisualInteractionSource : CompositionObject, ICompositionInteractionSource

Public Class VisualInteractionSource
Inherits CompositionObject
Implements ICompositionInteractionSource

継承

Object Platform::Object IInspectable CompositionObject VisualInteractionSource

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

実装

ICompositionInteractionSource

例

void SetupSimpleInteractionTracker(Visual viewportVisual, Visual contentVisual)
{
  //
  // Create the InteractionTracker and set its min/max position and scale.  These could 
  // also be bound to expressions.  Note: The scrollable area can be changed from either 
  // end to facilitate content updates/virtualization.
  //

  _tracker = InteractionTracker.Create(_compositor);

  _tracker.MaxPosition = new Vector3(
    contentVisual.Size.X - viewportVisual.Size.X,
    contentVisual.Size.Y - viewportVisual.Size.Y,
    0.0f);

  _tracker.MinScale = 0.5f;
  _tracker.MaxScale = 4.0f;


  //
  // Configure the interaction source.  Enable input with inertia on all axis.
  //

  var interactionSource = VisualInteractionSource.Create(viewportVisual);

  interactionSource.PositionXSourceMode = InteractionSourceMode.EnabledWithInertia;
  interactionSource.PositionYSourceMode = InteractionSourceMode.EnabledWithInertia;
  interactionSource.ScaleSourceMode = InteractionSourceMode.EnabledWithInertia;

  _tracker.InteractionSources.Add(interactionSource);


  //
  // Bind the InteractionTracker outputs to the contentVisual.
  //

  var positionExpression = _compositor.CreateExpressionAnimation("-tracker.Position");
  positionExpression.SetReferenceParameter("tracker", _tracker);

  contentVisual.StartAnimation("Offset", positionExpression);


  var scaleExpression = _compositor.CreateExpressionAnimation("Vector3(tracker.Scale, tracker.Scale, 1.0)");

  scaleExpression.SetReferenceParameter("tracker", _tracker);

  contentVisual.StartAnimation("Scale", scaleExpression);
}

注釈

VisualInteractionSource は、InteractionTracker の状態とプロパティを駆動する必要がある相互作用の種類に関する重要なプロパティを定義するために使用されます。 source プロパティは、ヒット テストとジェスチャ検出の座標空間の両方に使用されます。 その結果、操作中に動かないビジュアルを使用することが重要です。 複数のヒット テスト領域がある場合、複数の VisualInteractionSource を同じ InteractionTracker に関連付けることができますが、最も一般的なケースでは、特定の InteractionTracker に対して VisualInteractionSource を 1 つだけ必要とします。

VisualInteractionSource は、InteractionTracker を駆動するために考慮する必要があるジェスチャの種類を構成するためのクラスです。 位置 X と Y は、それぞれ水平方向と垂直方向のパンに関連付けられます。 スケーリングは、多くの場合、ズームに関連付けられたピンチ ジェスチャで検出されます。 これら 3 つのソース モードはすべて、タッチおよび高精度タッチパッド入力用に構成できます。 これらの各ソース モードは、慣性の有無にかかわらず有効にすることができます。

• 慣性を有効にすると、位置またはスケールは、慣性状態中に解放速度から速度なしで自然に補間されることを示します。

• 慣性を無効にすると、相互作用の完了時に位置またはスケール速度が直ちに 0 に移動することを示します。 位置またはスケールを駆動する入力が InteractionTracker にルーティングされると、同じ名前の InteractionTracker プロパティが適切に更新されます。

Rails の構成は、ジェスチャがどのように検出されるかを示します。 既定では、Rails は オンであり、主にその軸で開始されたときに、水平または垂直パンが特定の軸にロックされることを示します。 この詳細については、手すりのプロパティ ページを参照してください。

チェーン構成は、InteractionTracker がその方向の最小値または最大値に達したときに、ある VisualInteractionSource によって処理された入力が別のエンティティに流れるかどうかを示します。 この構成により、別の VisualInteractionSource を介して別の InteractionTracker に、または VisualInteractionSource のソース ビジュアルが ScrollViewer の子である場合は ScrollViewer への入力が許可されます。

プロパティ

メソッド

適用対象

こちらもご覧ください

• CompositionObject
• ICompositionInteractionSource
• IClosable