CompositionTarget.Rendering Ereignis

Definition

Namespace:

System.Windows.Media

Assembly:

PresentationCore.dll

Tritt unmittelbar vor dem Rendern der Objekte in der Kompositionsstruktur auf.

public:
 static event EventHandler ^ Rendering;

public static event EventHandler Rendering;

member this.Rendering : EventHandler 

Public Shared Custom Event Rendering As EventHandler 

Ereignistyp

EventHandler

Beispiele

Das Rendering Ereignis wird während des WPF-Renderingprozesses (Windows Presentation Foundation) ausgelöst. Im folgenden Beispiel wird gezeigt, wie Sie einen EventHandler-Delegaten für die statische Rendering-Methode in CompositionTarget registrieren.

// 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

Sie können ihren Renderingereignishandler verwenden, um benutzerdefinierte Zeichnungsinhalte zu erstellen. Dieser Ereignishandler wird einmal pro Frame aufgerufen. Jedes Mal, wenn Windows Presentation Foundation (WPF) die persistenten Renderingdaten in der visuellen Struktur an die Kompositionsstruktur verteilt, wird Ihr Ereignishandler aufgerufen. Wenn Änderungen an der visuellen Struktur Außerdem Aktualisierungen der Kompositionsstruktur erzwingen, wird Ihr Ereignishandler auch aufgerufen. Beachten Sie, dass Ihr Ereignishandler aufgerufen wird, nachdem das Layout berechnet wurde. Sie können jedoch das Layout in Ihrem Ereignishandler ändern, was bedeutet, dass das Layout vor dem Rendern erneut berechnet wird.

Hinweise

Das Rendering Ereignis wird an den angegebenen Ereignishandler weitergeleitet, nachdem Animation und Layout auf die Kompositionsstruktur angewendet wurden.