CompositionTarget Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Représente la surface d’affichage composite d’une application. Cette classe fournit des événements de rendu à l’échelle de l’application.
public ref class CompositionTarget sealed/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 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(Microsoft.UI.Xaml.WinUIContract), 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- Héritage
- Attributs
Remarques
Les événements CompositionTarget sont utiles pour les scénarios de rendu tels que :
synchronisation du rendu d’interopérabilité DirectX à l’aide de l’événement Rendering
mesure du temps de rendu de l’image à l’aide de l’événement Rendu
régénérateur de contenu visuel personnalisé à l’écran en réponse à l’événement SurfaceContentsLost , par exemple la régénération d’un contenu RenderTargetBitmap ou d’interopérabilité DirectX dans un SurfaceImageSource
Pour les scénarios qui n’impliquent pas de rendu personnalisé ou de mesure du temps d’exécution, vous n’aurez probablement pas besoin de CompositionTarget et pouvez simplement vous appuyer sur le système de rendu XAML qui exécute et exécute toutes vos composition et disposition.
Méthodes
| GetCompositorForCurrentThread() |
Récupère l’objet Compositor pour ce thread. |
Événements
| Rendered |
Se produit immédiatement après que le processus de rendu de base a rendu une image. Cet événement vous permet de déterminer la durée du rendu de chaque image. |
| Rendering |
Se produit lorsque le processus de rendu de base rend une image. |
| SurfaceContentsLost |
Se produit lorsqu’un changement majeur sous-jacent se produit, tel qu’un changement d’appareil DirectX. En règle générale, l’application doit régénérer le contenu de sa surface lorsqu’elle est avertie de cet événement. |