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