CompositionTarget 类

定义

命名空间:

Windows.UI.Xaml.Media

表示应用的复合显示图面。 此类提供应用程序范围的呈现事件。

public ref class CompositionTarget sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 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(Windows.Foundation.UniversalApiContract), 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

继承

Object Platform::Object IInspectable CompositionTarget

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

注解

CompositionTarget 事件对于呈现方案非常有用，例如：

• 使用 Rendering 事件同步 DirectX 互操作呈现

• 使用 Rendered 事件测量帧呈现时间

• 在屏幕上重新生成自定义视觉内容以响应 SurfaceContentsLost 事件，例如在 SurfaceImageSource 中重新生成 RenderTargetBitmap 或 DirectX 互操作内容

对于不涉及自定义呈现或帧时间测量的方案，你可能不需要 CompositionTarget，并且只能依赖于运行和执行所有合成和布局的 XAML 呈现系统。

版本历史记录

Windows 版本	SDK 版本	增值
1803	17134	呈现

事件

Rendered	在核心呈现过程呈现帧后立即发生。 此事件可让你确定每个帧呈现所需的时间。
Rendering	在核心呈现过程呈现帧时发生。
SurfaceContentsLost	在发生基础主要更改（如 DirectX 设备更改）时发生。 通常，在收到此事件通知时，应用程序必须重新生成其图面内容。

另请参阅

• DirectX 和 XAML 互操作
• 优化动画和媒体