CompositionTarget.Rendering É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 juste avant que les objets dans l’arborescence de composition ne soient rendus.
public:
static event EventHandler ^ Rendering;
public static event EventHandler Rendering;
member this.Rendering : EventHandler
Public Shared Custom Event Rendering As EventHandler
Type d'événement
Exemples
L’événement Rendering est déclenché pendant le processus de rendu Windows Presentation Foundation (WPF). L’exemple suivant montre comment inscrire un EventHandler délégué à la méthode statique Rendering sur CompositionTarget.
// Add an event handler to update canvas background color just before it is rendered.
CompositionTarget.Rendering += UpdateColor;
' Add an event handler to update canvas background color just before it is rendered.
AddHandler CompositionTarget.Rendering, AddressOf UpdateColor
Vous pouvez utiliser votre gestionnaire d’événements de rendu pour créer du contenu de dessin personnalisé. Ce gestionnaire d’événements est appelé une fois par image. Chaque fois que Windows Presentation Foundation (WPF) marshale les données de rendu persistantes de l’arborescence visuelle dans l’arborescence de composition, votre gestionnaire d’événements est appelé. En outre, si les modifications apportées à l’arborescence visuelle forcent les mises à jour de l’arborescence de composition, votre gestionnaire d’événements est également appelé. Notez que votre gestionnaire d’événements est appelé après le calcul de la disposition. Toutefois, vous pouvez modifier la disposition dans votre gestionnaire d’événements, ce qui signifie que la disposition sera calculée une fois de plus avant le rendu.
Remarques
L’événement Rendering est acheminé vers le gestionnaire d’événements spécifié une fois l’animation et la disposition appliquées à l’arborescence de composition.