CompositionTarget Classe

Definição

Namespace:

Windows.UI.Xaml.Media

Representa a superfície de exibição composta para um aplicativo. Essa classe fornece eventos de renderização em todo o aplicativo.

public ref class CompositionTarget sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class CompositionTarget final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class CompositionTarget

Public NotInheritable Class CompositionTarget

Herança

Object Platform::Object IInspectable CompositionTarget

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Comentários

Os eventos CompositionTarget são úteis para renderizar cenários como:

• sincronizando a renderização de interoperabilidade do DirectX usando o evento Rendering

• medindo o tempo de renderização do quadro usando o evento Renderizado

• regenerando conteúdo visual personalizado na tela em resposta ao evento SurfaceContentsLost , por exemplo, regenerando um conteúdo de interoperabilidade RenderTargetBitmap ou DirectX em um SurfaceImageSource

Para cenários que não envolvem renderização personalizada ou medida de tempo de quadro, você provavelmente não precisará de CompositionTarget e pode apenas contar com o sistema de renderização XAML em execução e executando toda a sua composição e layout.

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1803	17134	Renderizado

Eventos

Rendered	Ocorre imediatamente após o processo de renderização principal renderizar um quadro. Esse evento permite determinar quanto tempo cada quadro leva para renderizar.
Rendering	Ocorre quando o processo de renderização principal renderiza um quadro.
SurfaceContentsLost	Ocorre quando ocorre uma alteração principal subjacente, como uma alteração de dispositivo DirectX. Normalmente, o aplicativo deve regenerar seu conteúdo de superfície quando notificado desse evento.

Confira também

• Interoperabilidade entre DirectX e XAML
• Otimizar animações e mídia