CompositionTarget.Rendered Événement

Définition

Espace de noms:

Windows.UI.Xaml.Media

Se produit immédiatement après que le processus de rendu principal a rendu un frame. Cet événement vous permet de déterminer le temps nécessaire au rendu de chaque image.

// Register
static event_token Rendered(EventHandler<RenderedEventArgs> const& handler) const;

// Revoke with event_token
static void Rendered(event_token const* cookie) const;

// Revoke with event_revoker
static CompositionTarget::Rendered_revoker Rendered(auto_revoke_t, EventHandler<RenderedEventArgs> const& handler) const;

public static event System.EventHandler<RenderedEventArgs> Rendered;

function onRendered(eventArgs) { /* Your code */ }
Windows.UI.Xaml.Media.CompositionTarget.addEventListener("rendered", onRendered);
Windows.UI.Xaml.Media.CompositionTarget.removeEventListener("rendered", onRendered);
- or -
Windows.UI.Xaml.Media.CompositionTarget.onrendered = onRendered;

Public Shared Custom Event Rendered As EventHandler(Of RenderedEventArgs) 

Type d'événement

EventHandler<RenderedEventArgs>

EventHandler<RenderedEventArgs>

Configuration requise pour Windows

Famille d’appareils	Windows 10, version 1803 (introduit dans 10.0.17134.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v6.0)

Remarques

Conseil

Nous vous recommandons d’utiliser le profileur de chronologie des applications Visual Studio lors du développement et du test de votre application. Il fournit des informations plus détaillées sur la consommation des ressources de votre application, notamment le temps consacré à la préparation des trames d’interface utilisateur.

Vous pouvez utiliser l’événement Rendu pour mesurer la durée des images et la réactivité des applications au moment de l’exécution sans Visual Studio ou un débogueur attaché. Par exemple, cela peut être utilisé pour générer des données de télémétrie pour les applications après leur déploiement, ou pour ajuster la quantité de rendu DirectX personnalisé qu’une application effectue à chaque image.

Une durée d’image plus longue signifie que votre application a dû effectuer plus de travail avant qu’une image puisse être rendue. Les durées d’images supérieures à environ 16 millisecondes signifient que votre application n’est pas en mesure de se mettre à jour à la fréquence recommandée de 60 images par seconde, ce qui peut entraîner un retard notable dans la réactivité de l’interface utilisateur.

Si vous voyez de longues durées d’images, envisagez de profiler votre application à l’aide de la chronologie de l’application Visual Studio et d’implémenter les meilleures pratiques recommandées en matière de performances.

Les gestionnaires pour rendu s’exécutent sur le thread d’interface utilisateur même s’ils ne sont liés à aucun élément d’interface utilisateur spécifique. Il est judicieux de supprimer tous les gestionnaires rendus lorsque vous n’en avez plus besoin et de les ajouter uniquement lorsque vous en avez besoin.