CompositionTarget
CompositionTarget
CompositionTarget
CompositionTarget
Class
Definition
Represents the composited display surface for an app. This class provides application-wide rendering events.
public : sealed class CompositionTargetstruct winrt::Windows::UI::Xaml::Media::CompositionTargetpublic sealed class CompositionTargetPublic NotInheritable Class CompositionTarget- Attributes
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:
synchronizing DirectX interop rendering using the Rendering event
measuring frame rendering time using the Rendered event
regenerating custom visual content on screen in response to the SurfaceContentsLost event, for example regenerating a RenderTargetBitmap or DirectX interop content in a SurfaceImageSource
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
Feedback
Loading feedback...