CompositionCommitBatch Classe

Définition

public ref class CompositionCommitBatch sealed : CompositionObject

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 131072)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class CompositionCommitBatch final : CompositionObject

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 131072)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class CompositionCommitBatch : CompositionObject

Public NotInheritable Class CompositionCommitBatch
Inherits CompositionObject

Héritage

Object Platform::Object IInspectable CompositionObject CompositionCommitBatch

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Exemples

Valider le lot

private void UsingCommitBatch()
{
  //Create Scoped batch for animations
  CompositionCommitBatch batch =  Compositor.GetCommitBatch(CompositionBatchTypes.Animation);

  //Setup completion event 
  batch.Completed += CommitBatchCompleted;

  //Setup animations
  Animation1(_target);
}

// Creates and defines the key frame animation 
private void Animation1(Visual targetVisual)
{
  var animation1 = _compositor.CreateVector3KeyFrameAnimation();

  animation1.InsertKeyFrame(0.0f, new Vector3(100.00f, 100.00f, 0.00f));
  animation1.InsertKeyFrame(0.5f, new Vector3(300.00f, 100.00f, 0.00f));
  animation1.InsertKeyFrame(1.0f, new Vector3(500.00f, 100.00f, 0.00f));

  animation1.Duration = TimeSpan.FromMilliseconds(2000);
  targetVisual.StartAnimation("Offset", animation1);
}

public void CommitBatchCompleted(object sender, CompositionBatchCompletedEventArgs args)
{
  _root.Children.Remove(_target);
}      

Remarques

Représente un groupe d’animations ou d’effets actifs et déclenche un rappel lorsque tous les membres du groupe sont terminés. Un CompositionCommitBatch est implicitement créé, mais doit être récupéré pour déclarer l’événement terminé. Un lot commit est implicitement fermé à la fin de chaque cycle de validation.

Pour un type de lot d’animation, le rappel se déclenche lorsque le délai et la durée combinés de l’animation la plus longue du lot sont écoulés. Pour un type de lot d’effets, le rappel se déclenche lorsque le traitement de tous les effets du lot est terminé.

Le lot commit actuel peut être récupéré en appelant Compositor.GetCommitBatch à tout moment pendant le cycle de validation. Le cycle de validation est défini comme le temps entre les mises à jour du composant. Mises à jour sont mis en file d’attente jusqu’à ce que le système soit prêt à traiter les modifications et à dessiner des bits à l’écran. Le lot Commit agrège tous les objets du cycle de validation, ceux avant et après l’appel de GetCommitBatch .   Le lot Commit est implicitement créé sur le thread de composition, le thread sur lequel le compositor est créé. Il ne peut y avoir qu’un seul composant par thread, donc un lot de validation par thread. Un lot commit doit être récupéré pour déclarer l’événement terminé. Un lot commit est implicitement fermé à la fin de chaque cycle de validation et ne peut pas être suspendu ou repris, ce qui entraîne une erreur en cas de tentative.

Pour plus d’informations sur les lots de composition, consultez Vue d’ensemble des animations de composition.

Propriétés

Méthodes

Événements

S’applique à

Voir aussi

• CompositionObject
• IClosable
• CompositionScopedBatch
• Vue d’ensemble des animations de composition