CompositionTarget.Rendering Evento

Definición

Se produce antes de que se representen los objetos en el árbol de composición.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 

Ejemplos

El Rendering evento se genera durante el Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) proceso de representación.The Rendering event is raised during the Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) rendering process. En el ejemplo siguiente se muestra cómo registrar EventHandler un delegado en el Rendering método estático CompositionTargeten.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

Puede usar el controlador de eventos de representación para crear contenido de dibujo personalizado.You can use your rendering event handler to create custom drawing content. Este controlador de eventos se llama una vez por fotograma.This event handler gets called once per frame. Cada vez que Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) calcula las referencias de los datos de representación conservados en el árbol visual en el árbol de composición, se llama al controlador de eventos.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. Además, si los cambios en el árbol visual fuerzan las actualizaciones en el árbol de composición, también se llama al controlador de eventos.In addition, if changes to the visual tree force updates to the composition tree, your event handler is also called. Tenga en cuenta que se llama al controlador de eventos una vez calculado el diseño.Note that your event handler is called after layout has been computed. Sin embargo, puede modificar el diseño en el controlador de eventos, lo que significa que el diseño se calculará una vez más antes de la representación.However, you can modify layout in your event handler, which means that layout will be computed once more before rendering.

Comentarios

El Rendering evento se enruta al controlador de eventos especificado después de haber aplicado la animación y el diseño al árbol de composición.The Rendering event is routed to the specified event handler after animation and layout have been applied to the composition tree.

Se aplica a