CompositionTarget Clase

Definición

Espacio de nombres:

Windows.UI.Xaml.Media

Representa la superficie de visualización compuesta de una aplicación. Esta clase proporciona eventos de representación en toda la aplicación.

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

Herencia

Object Platform::Object IInspectable CompositionTarget

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Comentarios

Los eventos CompositionTarget son útiles para representar escenarios como:

• sincronización de la representación de interoperabilidad de DirectX mediante el evento Rendering

• medición del tiempo de representación de fotogramas mediante el evento Representado

• regeneración de contenido visual personalizado en pantalla en respuesta al evento SurfaceContentsLost , por ejemplo, regeneración de un contenido de interoperabilidad renderTargetBitmap o DirectX en surfaceImageSource

En escenarios que no implican la representación personalizada o la medición de tiempo de fotogramas, probablemente no necesitará CompositionTarget y solo puede basarse en el sistema de representación XAML que se ejecuta y realiza toda la composición y el diseño.

Historial de versiones

Versión de Windows	Versión del SDK	Valor agregado
1803	17134	Representado

Eventos

Rendered	Se produce inmediatamente después de que el proceso de representación principal represente un marco. Este evento le permite determinar cuánto tiempo tarda cada fotograma en representarse.
Rendering	Se produce cuando el proceso de representación principal representa un marco.
SurfaceContentsLost	Se produce cuando se produce un cambio importante subyacente, como un cambio de dispositivo DirectX. Normalmente, la aplicación debe volver a generar su contenido de superficie cuando se le notifique de este evento.

Consulte también

• Interoperabilidad de DirectX y XAML
• Optimización de animaciones y medios