CompositionTarget CompositionTarget CompositionTarget CompositionTarget Class

Definition

Namespace:
Windows.UI.Xaml.Media Windows.UI.Xaml.Media Windows.UI.Xaml.Media Windows.UI.Xaml.Media

Some information relates to pre-released product which may be substantially modified before it’s commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Prerelease APIs are identified by a Prerelease label.

Edit

[Contains prerelease APIs.]
Represents the composited display surface for an app. This class is mainly for Microsoft DirectX content interop scenarios.

public : sealed class CompositionTarget : ICompositionTarget
struct winrt::Windows::UI::Xaml::Media::CompositionTarget : ICompositionTarget
public sealed class CompositionTarget : ICompositionTarget
Public NotInheritable Class CompositionTarget Implements ICompositionTarget
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 has one member, Rendering. Rendering is a static event that is fired by the XAML rendering system overall, not by the Application, Window, Page or any other specific object part of an app. CompositionTarget 's sole purpose is to provide this hook into the rendering process. That's mainly relevant only to Microsoft DirectX content interop scenarios where you want to know when the XAML rendering happens, so that you can execute some Microsoft DirectX code in response. For scenarios that don't involve Microsoft DirectX content you probably won't need Rendering and can just rely on the XAML rendering system running and performing all your composition and layout.

Events

Rendered Rendered Rendered Rendered

Prerelease. 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