CompositionTarget Klasse

Referenz

Definition

Namespace:: Windows.UI.Xaml.Media

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Stellt die zusammengesetzte Anzeigeoberfläche für eine App dar. Diese Klasse stellt anwendungsweite Renderingereignisse bereit.

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

Vererbung: Object Platform::Object IInspectable CompositionTarget

Attribute: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

CompositionTarget-Ereignisse sind nützlich für Renderingszenarien wie:

Synchronisieren des DirectX-Interoperabilitätsrenderings mithilfe des Rendering-Ereignisses
Messen der Framerenderungszeit mithilfe des gerenderten Ereignisses
Erneutes Generieren benutzerdefinierter visueller Inhalte auf dem Bildschirm als Reaktion auf das SurfaceContentsLost-Ereignis , z. B. erneutes Generieren eines RenderTargetBitmap - oder DirectX-Interopinhalts in einem SurfaceImageSource-Objekt

Für Szenarien ohne benutzerdefiniertes Rendering oder Framezeitmessung benötigen Sie wahrscheinlich compositionTarget nicht und können sich einfach darauf verlassen, dass das XAML-Renderingsystem ausgeführt wird und Ihre gesamte Komposition und Ihr Layout ausführt.

Versionsverlauf

Windows-Version	SDK-Version	Mehrwert
1803	17134	Gerendert

Ereignisse

Rendered	Tritt unmittelbar auf, nachdem der Kernrenderingprozess einen Frame gerendert hat. Mit diesem Ereignis können Sie bestimmen, wie lange das Rendern jedes Frames dauert.
Rendering	Tritt auf, wenn der Kernrenderingprozess einen Frame rendert.
SurfaceContentsLost	Tritt auf, wenn eine zugrunde liegende größere Änderung auftritt, z. B. eine DirectX-Geräteänderung. In der Regel muss die Anwendung ihren Oberflächeninhalt neu generieren, wenn sie über dieses Ereignis benachrichtigt wird.

Gilt für:

Freigeben über