CompositionTarget.Rendering Ereignis
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
Beispiele
Das Rendering-Ereignis wird während des Windows Presentation Foundation (WPF)-Renderingvorgangs ausgelöst. Das folgende Beispiel zeigt, wie Sie einen EventHandler Delegaten für die statische Rendering Methode CompositionTargetregistrieren.
// 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 den Renderereignishandler verwenden, um benutzerdefinierte Zeichnungsinhalte zu erstellen. Dieser Ereignishandler wird einmal pro Frame aufgerufen. Jedes Mal, wenn Windows Presentation Foundation (WPF) die gespeicherten Renderingdaten in der visuellen Struktur über die Kompositionsstruktur hinweg marshallt, wird der Ereignishandler aufgerufen. Wenn Änderungen an der visuellen Struktur außerdem Aktualisierungen der Kompositionsstruktur erzwingen, wird der 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 noch einmal berechnet wird.
Hinweise
Das Rendering Ereignis wird an den angegebenen Ereignishandler weitergeleitet, nachdem Animation und Layout auf die Kompositionsstruktur angewendet wurden.
