CompositionTarget
CompositionTarget
CompositionTarget
CompositionTarget
Class
Definition
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.
[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
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. |