CompositionTarget Classe

Référence

Définition

Espace de noms:: Windows.UI.Xaml.Media

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.

Modifier

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(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

Héritage: Object Platform::Object IInspectable CompositionTarget

Attributs: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

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.

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
1803	17134	Rendu

É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.

S’applique à