CompositionCommitBatch Classe

Référence

Définition

Espace de noms:: Microsoft.UI.Composition

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

Groupe d’animations ou d’effets actifs.

public ref class CompositionCommitBatch sealed : CompositionObject

/// [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)]
class CompositionCommitBatch final : CompositionObject

/// [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 CompositionCommitBatch final : CompositionObject

[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 sealed class CompositionCommitBatch : CompositionObject

[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 CompositionCommitBatch : CompositionObject

Public NotInheritable Class CompositionCommitBatch
Inherits CompositionObject

Héritage: Object Platform::Object IInspectable CompositionObject CompositionCommitBatch

Attributs: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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 Objet CompositionCommitBatch est créé implicitement, mais doit être récupéré pour déclarer l’événement terminé. Un lot de validations 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 se 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 de validation 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 compositeur. 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 compositeur est créé. Il ne peut y avoir qu’un seul compositeur par thread, donc un lot de validation par thread. Un lot de validation doit être récupéré pour déclarer l’événement terminé. Un lot de validations 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

Comment	Chaîne à associer à l’objet CompositionObject. (Hérité de CompositionObject)
Compositor	Compositeur utilisé pour créer cet Objet CompositionObject. (Hérité de CompositionObject)
DispatcherQueue	Obtient dispatcherQueue pour l’objet CompositionObject. (Hérité de CompositionObject)
ImplicitAnimations	Collection d’animations implicites attachées à cet objet. (Hérité de CompositionObject)
IsActive	Indique si compositionCommitBatch est actuellement ouvert pour les objets à agréger.
IsEnded	Indique si compositionCommitBatch a été fermé et ne peut plus accepter les modifications.
Properties	Collection de propriétés associées à CompositionObject. (Hérité de CompositionObject)

Méthodes

Close()	Ferme l’objet CompositionObject et libère les ressources système. (Hérité de CompositionObject)
Dispose()	Exécute les tâches définies par l'application associées à la libération ou à la redéfinition des ressources non managées. (Hérité de CompositionObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)	Définit une propriété qui peut être animée. (Hérité de CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	Connecte une animation avec la propriété spécifiée de l’objet et démarre l’animation. (Hérité de CompositionObject)
StartAnimation(String, CompositionAnimation)	Connecte une animation avec la propriété spécifiée de l’objet et démarre l’animation. (Hérité de CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	Démarre un groupe d’animations. La méthode StartAnimationGroup sur CompositionObject vous permet de démarrer CompositionAnimationGroup. Toutes les animations du groupe sont démarrées en même temps sur l’objet . (Hérité de CompositionObject)
StopAnimation(String)	Déconnecte une animation de la propriété spécifiée et arrête l’animation. (Hérité de CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	Arrête un groupe d’animations. (Hérité de CompositionObject)
TryGetAnimationController(String)	Renvoie un AnimationController pour l’animation en cours d’exécution sur la propriété spécifiée. (Hérité de CompositionObject)

Événements

Completed

Événement déclenché lorsque tous les objets d’un Objet CompositionCommitBatch sont terminés.

S’applique à

Partager via