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 事件適用于轉譯案例，例如：

• 使用轉譯事件同步處理DirectX Interop 轉譯

• 使用 Rendered 事件測量畫面格轉譯時間

• 重新產生畫面上的自訂視覺內容以回應SurfaceContentsLost事件，例如重新產生SurfaceImageSource中的RenderTargetBitmap或 DirectX Interop 內容

對於未涉及自訂轉譯或框架時間測量的案例，您可能不需要 CompositionTarget，而且只能依賴執行並執行您所有組合和配置的 XAML 轉譯系統。

版本歷程記錄

Windows 版本	SDK 版本	已新增值
1803	17134	已轉譯

事件

Rendered	會在核心轉譯程式轉譯框架之後立即發生。 此事件可讓您判斷每個畫面需要多久才能呈現。
Rendering	發生于核心轉譯程式轉譯框架時。
SurfaceContentsLost	發生基礎主要變更時發生，例如 DirectX 裝置變更。 應用程式通常必須在收到此事件的通知時重新產生其表面內容。

另請參閱

• DirectX 與 XAML 互通性
• 優化動畫和媒體