CompositionCommitBatch Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Um grupo de animações ou efeitos ativos.
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- Herança
- Atributos
Requisitos do Windows
| Família de dispositivos |
Windows 10 (introduzida na 10.0.10586.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduzida na v2.0)
|
Exemplos
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);
}
Comentários
Representa um grupo de animações ou efeitos ativos e dispara um retorno de chamada quando todos os membros do grupo são concluídos. Um CompositionCommitBatch é criado implicitamente, mas deve ser recuperado para declarar o evento concluído. Um lote de confirmação será implicitamente fechado no final de cada ciclo de confirmação.
Para um tipo de lote de animação, o retorno de chamada é disparado quando o atraso combinado e a duração da animação mais longa no lote tiver decorrido. Para um tipo de lote de efeito, o retorno de chamada é disparado quando o processamento de todos os efeitos no lote é concluído.
O lote de Confirmação atual pode ser recuperado chamando Compositor.GetCommitBatch a qualquer momento durante o ciclo de confirmação. O ciclo de confirmação é definido como o tempo entre as atualizações do compositor. Atualizações são enfileirados até que o sistema esteja pronto para processar as alterações e desenhar bits na tela. O lote commit agregará todos os objetos dentro do ciclo de confirmação, aqueles antes e depois que GetCommitBatch foi chamado. O lote commit é criado implicitamente no thread de composição, o thread no qual o compositor é criado. Só pode haver um compositor por thread, portanto, um lote de confirmação por thread. Um lote de confirmação deve ser recuperado para declarar o evento concluído. Um lote de Confirmação será implicitamente fechado no final de cada ciclo de confirmação e não poderá ser suspenso ou retomado, isso resultará em um erro se for tentada.
Consulte Visão geral de animações de composição para obter mais informações sobre lotes de composição.
Propriedades
| Comment |
Uma cadeia de caracteres a ser associada ao CompositionObject. (Herdado de CompositionObject) |
| Compositor |
O Compositor usado para criar este CompositionObject. (Herdado de CompositionObject) |
| Dispatcher |
O dispatcher do CompositionObject. (Herdado de CompositionObject) |
| DispatcherQueue |
Obtém o DispatcherQueue para o CompostionObject. (Herdado de CompositionObject) |
| ImplicitAnimations |
A coleção de animações implícitas anexadas a esse objeto. (Herdado de CompositionObject) |
| IsActive |
Indica se o CompositionCommitBatch está aberto no momento para que os objetos sejam agregados. |
| IsEnded |
Indica se CompositionCommitBatch foi fechado e não pode mais aceitar alterações. |
| Properties |
A coleção de propriedades associadas ao CompositionObject. (Herdado de CompositionObject) |
Métodos
| Close() |
Fecha o CompositionObject e libera os recursos do sistema. (Herdado de CompositionObject) |
| ConnectAnimation(String, CompositionAnimation) |
Conecta e animação. (Herdado de CompositionObject) |
| DisconnectAnimation(String) |
Desconecta uma animação. (Herdado de CompositionObject) |
| Dispose() |
Realiza tarefas definidas pelo aplicativo associadas à liberação ou à redefinição de recursos não gerenciados. (Herdado de CompositionObject) |
| PopulatePropertyInfo(String, AnimationPropertyInfo) |
Define uma propriedade que pode ser animada. (Herdado de CompositionObject) |
| StartAnimation(String, CompositionAnimation, AnimationController) |
Conecta uma animação com a propriedade especificada do objeto e inicia a animação. (Herdado de CompositionObject) |
| StartAnimation(String, CompositionAnimation) |
Conecta uma animação com a propriedade especificada do objeto e inicia a animação. (Herdado de CompositionObject) |
| StartAnimationGroup(ICompositionAnimationBase) |
Inicia um grupo de animação. O método StartAnimationGroup em CompositionObject permite iniciar CompositionAnimationGroup. Todas as animações no grupo serão iniciadas ao mesmo tempo no objeto . (Herdado de CompositionObject) |
| StopAnimation(String) |
Desconecta uma animação da propriedade especificada e interrompe a animação. (Herdado de CompositionObject) |
| StopAnimationGroup(ICompositionAnimationBase) |
Interrompe um grupo de animação. (Herdado de CompositionObject) |
| TryGetAnimationController(String) |
Retorna um AnimationController para a animação em execução na propriedade especificada. (Herdado de CompositionObject) |
Eventos
| Completed |
Evento que é disparado quando todos os objetos em um CompositionCommitBatch são concluídos. |