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 

イベント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 CompositionTarget静的Renderingメソッドにデリゲートを登録する方法を示しています。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.

注釈

アニメーションとレイアウトがコンポジションツリーに適用された後、イベントは指定されたイベントハンドラーにルーティングされます。RenderingThe Rendering event is routed to the specified event handler after animation and layout have been applied to the composition tree.

適用対象