CompositionInteractionSourceCollection Classe

Definizione

Spazio dei nomi:

Microsoft.UI.Composition.Interactions

Raccolta di origini di interazione.

Si tratta della raccolta di origini di interazione associate a un determinato InteractionTracker. L'unico membro valido di questa raccolta è VisualInteractionSource. Ogni oggetto VisualInteractionSource deve avere un oggetto visivo di hit test (origine) univoco. Ogni Oggetto VisualInteractionSource verrà configurato singolarmente per l'input desiderato da inviare all'InteractionTracker.

public ref class CompositionInteractionSourceCollection sealed : CompositionObject, IIterable<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)]
class CompositionInteractionSourceCollection final : CompositionObject, IIterable<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 sealed class CompositionInteractionSourceCollection : CompositionObject, IEnumerable<ICompositionInteractionSource>

Public NotInheritable Class CompositionInteractionSourceCollection
Inherits CompositionObject
Implements IEnumerable(Of ICompositionInteractionSource)

Ereditarietà

Object Platform::Object IInspectable CompositionObject CompositionInteractionSourceCollection

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementazioni

IIterable<ICompositionInteractionSource> IEnumerable<ICompositionInteractionSource>

Esempio

void SetupMultipleSourceInteractionTracker(Visual horizontalVisual, Visual verticalVisual, Visual contentVisual)
{
  //
  // Create the InteractionTracker and set its min/max position.  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);


  //
  // Configure the two interaction sources.  Enable input with inertia.  
  //

  var interactionSource1 = VisualInteractionSource.Create(horizontalVisual);
  var interactionSource2 = VisualInteractionSource.Create(verticalVisual);

  interactionSource1.PositionXSourceMode = 
  InteractionSourceMode.EnabledWithInertia; 

  interactionSource2.PositionYSourceMode = 
  InteractionSourceMode.EnabledWithInertia;


  _tracker.InteractionSources.Add(interactionSource1);
  _tracker.InteractionSources.Add(interactionSource2);


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

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

  contentVisual.StartAnimation("Offset", positionExpression);
}

Commenti

Sebbene più CompositionInteractionSources possa essere aggiunto allo stesso CompositionInteractionSourceCollection, il caso più comune consiste nell'avere un solo membro in questa raccolta. Più possono essere usati se più aree di hit test devono guidare lo stesso InteractionTracker. Se più oggetti visivi di origine vengono hit test contemporaneamente, la gerarchia dell'albero visivo determina quale precedenza. Se un padre comune contiene più contatti di hit test rispetto a un singolo figlio, l'input verrà promosso a tale padre.

Proprietà

Comment	Stringa da associare a CompositionObject. (Ereditato da CompositionObject)
Compositor	Compositore usato per creare questo oggetto CompositionObject. (Ereditato da CompositionObject)
Count	Numero di origini di interazione nella raccolta.
DispatcherQueue	Ottiene DispatcherQueue per CompositionObject. (Ereditato da CompositionObject)
ImplicitAnimations	Raccolta di animazioni implicite associate a questo oggetto. (Ereditato da CompositionObject)
Properties	Raccolta di proprietà associate a CompositionObject. (Ereditato da CompositionObject)

Metodi

Add(ICompositionInteractionSource)	Aggiunge un'origine di interazione alla raccolta.
Close()	Chiude l'oggetto CompositionObject e rilascia le risorse di sistema. (Ereditato da CompositionObject)
Dispose()	Esegue attività definite dall'applicazione, come rilasciare o reimpostare risorse non gestite. (Ereditato da CompositionObject)
First()	Restituisce un iteratore che punta al primo oggetto dell'insieme.
PopulatePropertyInfo(String, AnimationPropertyInfo)	Definisce una proprietà che può essere animata. (Ereditato da CompositionObject)
Remove(ICompositionInteractionSource)	Rimuove l'origine di interazione specificata dall'insieme.
RemoveAll()	Rimuove tutte le origini di interazione dalla raccolta.
StartAnimation(String, CompositionAnimation, AnimationController)	Connette un'animazione con la proprietà specificata dell'oggetto e avvia l'animazione. (Ereditato da CompositionObject)
StartAnimation(String, CompositionAnimation)	Connette un'animazione con la proprietà specificata dell'oggetto e avvia l'animazione. (Ereditato da CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	Avvia un gruppo di animazioni. Il metodo StartAnimationGroup in CompositionObject consente di avviare CompositionAnimationGroup. Tutte le animazioni del gruppo verranno avviate contemporaneamente sull'oggetto. (Ereditato da CompositionObject)
StopAnimation(String)	Disconnette un'animazione dalla proprietà specificata e arresta l'animazione. (Ereditato da CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	Arresta un gruppo di animazioni. (Ereditato da CompositionObject)
TryGetAnimationController(String)	Restituisce un oggetto AnimationController per l'animazione in esecuzione nella proprietà specificata. (Ereditato da CompositionObject)

Vedi anche

• CompositionObject
• IClosable
• IIterable(ICompositionInteractionSource)