CompositionTarget CompositionTarget CompositionTarget CompositionTarget Class

Definition

Namespace:
Windows.UI.Xaml.Media Windows.UI.Xaml.Media Windows.UI.Xaml.Media Windows.UI.Xaml.Media
Assemblies:
Windows.UI.Xaml.Media.dll, Windows.dll
Edit

Represents the composited display surface for an app. This class provides application-wide rendering events.

public : sealed class CompositionTarget
struct winrt::Windows::UI::Xaml::Media::CompositionTarget
public sealed class CompositionTarget
Public NotInheritable Class CompositionTarget
Attributes
ContractVersionAttribute MarshalingBehaviorAttribute StaticAttribute ThreadingAttribute WebHostHiddenAttribute

Windows 10 requirements

Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Remarks

CompositionTarget events are useful for rendering scenarios like:

For scenarios that don't involve custom rendering or frame time measurement you probably won't need CompositionTarget and can just rely on the XAML rendering system running and performing all your composition and layout.

Version history

Windows version SDK version Value added
1803 17134 Rendered

Events

Rendered Rendered Rendered Rendered

Occurs immediately after the core rendering process renders a frame. This event lets you determine how long each frame takes to render.
Rendering Rendering Rendering Rendering

Occurs when the core rendering process renders a frame.
SurfaceContentsLost SurfaceContentsLost SurfaceContentsLost SurfaceContentsLost

Occurs when an underlying major change occurs, such as a DirectX device change. Typically the application must regenerate its surface contents when notified of this event.

See also