CompositionTarget Class

Represents the display surface of your application.

Namespace: System.Windows.Media
Assembly: PresentationCore (in presentationcore.dll)
XML Namespace:

public abstract class CompositionTarget : DispatcherObject, IDisposable
public abstract class CompositionTarget extends DispatcherObject implements IDisposable
public abstract class CompositionTarget extends DispatcherObject implements IDisposable
This class is abstract; see Inheritance Hierarchy for derived non-abstract classes usable in XAML.

CompositionTarget is a class which represents the display surface on which your application is being drawn. The WPF animation engine provides many features for creating frame-based animation. However, there are application scenarios in which you need finer-grained control over rendering on a per frame basis. The CompositionTarget object provides the ability to create custom animations based on a per-frame callback.


For a complete code sample using CompositionTarget, see Using the CompositionTarget Sample.

Using Perforator to Analyze Rendering Behavior

Perforator is a WPF performance profiling tool for analyzing rendering behavior. Perforator displays a set of values that allow you to analyze very specific rendering behavior in parts of your application. In this case, Perforator shows a rendering frame rate of 60 frames per second for the PhotoDemo sample application.

Perforator main window

Perforator main window with rendering data

For more information, see Performance Profiling Tools for WPF.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0