CompositionTarget.Rendering Событие

Определение

Происходит непосредственно перед отрисовкой объектов в дереве композиции.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 

Тип события

EventHandler

Примеры

RenderingСобытие возникает во время процесса отрисовки Windows Presentation Foundation (WPF).The Rendering event is raised during the Windows Presentation Foundation (WPF) rendering process. В следующем примере показано, как зарегистрировать EventHandler делегат для статического Rendering метода в 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

Вы можете использовать обработчик событий отрисовки для создания пользовательского содержимого рисования.You can use your rendering event handler to create custom drawing content. Этот обработчик событий вызывается один раз для каждого кадра.This event handler gets called once per frame. Каждый раз, когда Windows Presentation Foundation (WPF) маршалирует сохраненные данные отрисовки в визуальном дереве по дереву композиции, вызывается обработчик событий.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. Кроме того, если изменения в визуальном дереве принудительно обновляют дерево композиции, также вызывается обработчик событий.In addition, if changes to the visual tree force updates to the composition tree, your event handler is also called. Обратите внимание, что обработчик событий вызывается после расчета макета.Note that your event handler is called after layout has been computed. Однако можно изменить макет в обработчике событий, что означает, что макет будет вычисляться еще раз перед отрисовкой.However, you can modify layout in your event handler, which means that layout will be computed once more before rendering.

Комментарии

RenderingСобытие направляется к указанному обработчику событий после того, как анимация и макет применены к дереву композиции.The Rendering event is routed to the specified event handler after animation and layout have been applied to the composition tree.

Применяется к