CompositionTarget.Rendered Événement

Définition

Espace de noms:

Microsoft.UI.Xaml.Media

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.

// 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 */ }
Microsoft.UI.Xaml.Media.CompositionTarget.addEventListener("rendered", onRendered);
Microsoft.UI.Xaml.Media.CompositionTarget.removeEventListener("rendered", onRendered);
- or -
Microsoft.UI.Xaml.Media.CompositionTarget.onrendered = onRendered;

Public Shared Custom Event Rendered As EventHandler(Of RenderedEventArgs) 

Type d'événement

EventHandler<RenderedEventArgs>

EventHandler<RenderedEventArgs>

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 de 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é de l’application 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 pour 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 affichée. Les durées de trame supérieures à environ 16 millisecondes signifient que votre application n’est pas en mesure de 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 des durées d’images longues, 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.