CompositionTarget 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í.
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 CompositionTargetPublic NotInheritable Class CompositionTarget- Herencia
- Atributos
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. |