CompositionTarget.Rendering CompositionTarget.Rendering CompositionTarget.Rendering CompositionTarget.Rendering Event

Definition

Tritt unmittelbar vor dem Rendern der Objekte in der Kompositionsstruktur auf.Occurs just before the objects in the composition tree are rendered.

public:
 static event EventHandler ^ Rendering;
public static event EventHandler Rendering;
member this.Rendering : EventHandler 
Public Shared Custom Event Rendering As EventHandler 

Beispiele

Das Rendering -Ereignis wird während des Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) Renderingprozesses ausgelöst.The Rendering event is raised during the Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) rendering process. Im folgenden Beispiel wird gezeigt, wie Sie EventHandler einen-Delegaten Rendering bei der CompositionTargetstatischen Methode für registrieren.The following example shows how you register an EventHandler delegate to the static Rendering method on 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

Sie können den Rendering-Ereignishandler verwenden, um benutzerdefinierten Zeichnungs Inhalt zu erstellen.You can use your rendering event handler to create custom drawing content. Dieser Ereignishandler wird einmal pro Frame aufgerufen.This event handler gets called once per frame. Jedes Mal, Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) wenn die persistenten Renderingdaten in der visuellen Struktur über die Kompositionsstruktur hinweg Marshalls werden, wird der Ereignishandler aufgerufen.Each time that Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) marshals the persisted rendering data in the visual tree across to the composition tree, your event handler is called. Wenn Änderungen an der visuellen Strukturänderungen an der Kompositionsstruktur erzwingen, wird auch der Ereignishandler aufgerufen.In addition, if changes to the visual tree force updates to the composition tree, your event handler is also called. Beachten Sie, dass der Ereignishandler nach dem Berechnen des Layouts aufgerufen wird.Note that your event handler is called after layout has been computed. Sie können jedoch das Layout in Ihrem Ereignishandler ändern, d. h., dass das Layout vor dem Rendering noch einmal berechnet wird.However, you can modify layout in your event handler, which means that layout will be computed once more before rendering.

Hinweise

Das Rendering Ereignis wird an den angegebenen Ereignishandler weitergeleitet, nachdem Animation und Layout auf die Kompositionsstruktur angewendet wurden.The Rendering event is routed to the specified event handler after animation and layout have been applied to the composition tree.

Gilt für: