Share via


CompositionTarget Class

Definition

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

public ref class CompositionTarget sealed
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class CompositionTarget final
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class CompositionTarget
Public NotInheritable Class CompositionTarget
Inheritance
Object Platform::Object IInspectable CompositionTarget
Attributes

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.

Methods

GetCompositorForCurrentThread()

Retrieves the Compositor object for this thread.

Events

Rendered

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

Rendering

Occurs when the core rendering process renders a frame.

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.

Applies to

See also