CompositionTarget.Rendering Event

定義

構成ツリーのオブジェクトがレンダリングされる直前に発生します。 Occurs just before the objects in the composition tree are rendered.

public static event EventHandler Rendering;

Rendering中にイベントが発生した、Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF)レンダリング プロセス。The Rendering event is raised during the Windows Presentation Foundation (WPF)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. このイベント ハンドラーは、フレームごとに 1 回呼び出されます。This event handler gets called once per frame. 毎回をWindows Presentation Foundation (WPF)Windows Presentation Foundation (WPF)マーシャ リングでは、構成ツリーをイベント ハンドラーがビジュアル ツリーの永続化されたレンダリング データと呼びます。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. さらに、ビジュアル ツリーへの変更は、構成ツリーに更新プログラムを強制する場合も、イベント ハンドラーが呼び出されます。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.

適用対象