Partage via


CompositionTarget.Rendering Événement

Définition

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.

S’applique à