CompositionCommitBatch Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Un grupo de animaciones o efectos activos.
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 : CompositionObjectPublic NotInheritable Class CompositionCommitBatch
Inherits CompositionObject- Herencia
- Atributos
Requisitos de Windows
| Familia de dispositivos |
Windows 10 (se introdujo en la versión 10.0.10586.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (se introdujo en la versión v2.0)
|
Ejemplos
Confirmar lote
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);
}
Comentarios
Representa un grupo de animaciones o efectos activos y desencadena una devolución de llamada cuando todos los miembros del grupo se han completado. Se crea implícitamente un compositionCommitBatch, pero se debe recuperar para declarar el evento completado. Un lote commit se cerrará implícitamente al final de cada ciclo de confirmación.
Para un tipo de lote de animación, la devolución de llamada se desencadena cuando ha transcurrido el retraso combinado y la duración de la animación más larga del lote. Para un tipo de lote de efecto, la devolución de llamada se desencadena cuando se ha completado el procesamiento de todos los efectos del lote.
El lote commit actual se puede recuperar llamando a Compositor.GetCommitBatch en cualquier momento durante el ciclo de confirmación. El ciclo de confirmación se define como el tiempo entre las actualizaciones desde el compositor. Las actualizaciones se ponen en cola hasta que el sistema esté listo para procesar los cambios y dibujar bits en la pantalla. El lote Commit agregará todos los objetos dentro del ciclo de confirmación, los antes y después de llamar a GetCommitBatch . El lote Commit se crea implícitamente en el subproceso de composición, el subproceso en el que se crea el compositor. Solo puede haber un compositor por subproceso, por lo tanto, un lote commit por subproceso. Se debe recuperar un lote commit para declarar el evento completado. Un lote commit se cerrará implícitamente al final de cada ciclo de confirmación y no se puede suspender o reanudar, lo que provocará un error si se intenta.
Consulte Información general sobre animaciones de composición para obtener más información sobre los lotes de composición.
Propiedades
| Comment |
Cadena que se va a asociar con compositionObject. (Heredado de CompositionObject) |
| Compositor |
Compositor que se usa para crear este CompositionObject. (Heredado de CompositionObject) |
| Dispatcher |
Distribuidor de CompositionObject. (Heredado de CompositionObject) |
| DispatcherQueue |
Obtiene dispatcherQueue para CompostionObject. (Heredado de CompositionObject) |
| ImplicitAnimations |
Colección de animaciones implícitas adjuntas a este objeto. (Heredado de CompositionObject) |
| IsActive |
Indica si compositionCommitBatch está abierto actualmente para que se agreguen objetos. |
| IsEnded |
Indica si compositionCommitBatch se ha cerrado y ya no puede aceptar cambios. |
| Properties |
Colección de propiedades asociadas a CompositionObject. (Heredado de CompositionObject) |
Métodos
| Close() |
Cierra compositionObject y libera los recursos del sistema. (Heredado de CompositionObject) |
| ConnectAnimation(String, CompositionAnimation) |
Conecta y animación. (Heredado de CompositionObject) |
| DisconnectAnimation(String) |
Desconecta una animación. (Heredado de CompositionObject) |
| Dispose() |
Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados. (Heredado de CompositionObject) |
| PopulatePropertyInfo(String, AnimationPropertyInfo) |
Define una propiedad que se puede animar. (Heredado de CompositionObject) |
| StartAnimation(String, CompositionAnimation, AnimationController) |
Conecta una animación con la propiedad especificada del objeto e inicia la animación. (Heredado de CompositionObject) |
| StartAnimation(String, CompositionAnimation) |
Conecta una animación con la propiedad especificada del objeto e inicia la animación. (Heredado de CompositionObject) |
| StartAnimationGroup(ICompositionAnimationBase) |
Inicia un grupo de animación. El método StartAnimationGroup en CompositionObject permite iniciar CompositionAnimationGroup. Todas las animaciones del grupo se iniciarán al mismo tiempo en el objeto . (Heredado de CompositionObject) |
| StopAnimation(String) |
Desconecta una animación de la propiedad especificada y detiene la animación. (Heredado de CompositionObject) |
| StopAnimationGroup(ICompositionAnimationBase) |
Detiene un grupo de animaciones. (Heredado de CompositionObject) |
| TryGetAnimationController(String) |
Devuelve un AnimationController para la animación que se ejecuta en la propiedad especificada. (Heredado de CompositionObject) |
Eventos
| Completed |
Evento que se desencadena cuando se han completado todos los objetos de compositionCommitBatch . |