CompositionTarget.Rendered Événement
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.
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
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.