CompositionTarget.Rendering Zdarzenie

Definicja

Występuje tuż przed renderowaniem obiektów w drzewie kompozycji.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 

Typ zdarzenia

EventHandler

Przykłady

RenderingZdarzenie jest wywoływane podczas procesu renderowania Windows Presentation Foundation (WPF).The Rendering event is raised during the Windows Presentation Foundation (WPF) rendering process. Poniższy przykład pokazuje, jak zarejestrować EventHandler delegata w Rendering metodzie statycznej na CompositionTarget .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

Możesz użyć procedury obsługi zdarzeń renderowania, aby utworzyć niestandardową zawartość rysunku.You can use your rendering event handler to create custom drawing content. Ta procedura obsługi zdarzeń jest wywoływana raz na klatkę.This event handler gets called once per frame. Za każdym razem, gdy Windows Presentation Foundation (WPF) kierujący utrwalone dane renderowania w drzewie wizualnym w drzewie kompozycji, program obsługi zdarzeń jest wywoływany.Each time that Windows Presentation Foundation (WPF) marshals the persisted rendering data in the visual tree across to the composition tree, your event handler is called. Ponadto, jeśli zmiany w drzewie wizualnym wymuśą aktualizacje drzewa kompozycji, program obsługi zdarzeń jest również wywoływany.In addition, if changes to the visual tree force updates to the composition tree, your event handler is also called. Należy pamiętać, że program obsługi zdarzeń jest wywoływany po obliczaniu układu.Note that your event handler is called after layout has been computed. Można jednak zmodyfikować układ w programie obsługi zdarzeń, co oznacza, że układ zostanie obliczony co więcej przed renderowaniem.However, you can modify layout in your event handler, which means that layout will be computed once more before rendering.

Uwagi

RenderingZdarzenie jest kierowane do określonego programu obsługi zdarzeń po zastosowaniu animacji i układu do drzewa kompozycji.The Rendering event is routed to the specified event handler after animation and layout have been applied to the composition tree.

Dotyczy