CompositionTarget 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.
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 CompositionTargetPublic NotInheritable Class CompositionTarget- Herança
- Atributos
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. |