英語で読む

次の方法で共有


CompositionTarget.Rendering イベント

定義

構成ツリーのオブジェクトがレンダリングされる直前に発生します。

C#
public static event EventHandler Rendering;

イベントの種類

イベントはRendering、Windows Presentation Foundation (WPF) レンダリング プロセス中に発生します。 次の例では、CompositionTarget の静的な Rendering メソッドに EventHandler デリゲートを登録する方法を示しています。

C#
// Add an event handler to update canvas background color just before it is rendered.
CompositionTarget.Rendering += UpdateColor;

レンダリング イベント ハンドラーを使用して、カスタム描画コンテンツを作成できます。 このイベント ハンドラーは、フレームごとに 1 回呼び出されます。 Windows Presentation Foundation (WPF) がビジュアル ツリー内の永続化されたレンダリング データをコンポジション ツリーにマーシャリングするたびに、イベント ハンドラーが呼び出されます。 さらに、ビジュアル ツリーに対する変更によってコンポジション ツリーが強制的に更新されると、イベント ハンドラーも呼び出されます。 イベント ハンドラーは、レイアウトの計算後に呼び出されることに注意してください。 ただし、イベント ハンドラーのレイアウトは変更できます。つまり、レイアウトはレンダリング前にもう一度計算されます。

注釈

イベントは Rendering 、アニメーションとレイアウトがコンポジション ツリーに適用された後、指定されたイベント ハンドラーにルーティングされます。

適用対象

製品 バージョン
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10