CompositionTarget Klasse
Definition
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.
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(Microsoft.UI.Xaml.WinUIContract, 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(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class CompositionTargetPublic NotInheritable Class CompositionTarget- Vererbung
- Attribute
Hinweise
CompositionTarget-Ereignisse sind nützlich für Renderingszenarien wie:
Synchronisieren des DirectX-Interoperabilitätsrenderings mithilfe des Renderingereignisses
Messen der Framerenderingzeit mithilfe des gerenderten Ereignisses
Generieren von benutzerdefinierten visuellen Inhalten auf dem Bildschirm als Reaktion auf das SurfaceContentsLost-Ereignis , z. B. Generieren eines RenderTargetBitmap - oder DirectX-Interoperabilitätsinhalts in einer SurfaceImageSource
Für Szenarien, in denen keine benutzerdefinierte Rendering- oder Framezeitmessung erforderlich ist, benötigen Sie wahrscheinlich keine CompositionTarget- und kann sich nur auf das AUSGEFÜHRTe XAML-Renderingsystem und das Ausführen aller Kompositions- und Layoutfunktionen verlassen.
Methoden
| Name | Beschreibung |
|---|---|
| GetCompositorForCurrentThread() |
Ruft das Kompositorobjekt für diesen Thread ab. |
Ereignisse
| Name | Beschreibung |
|---|---|
| Rendered |
Tritt unmittelbar nach dem Rendern des Kernrenderingprozesses ein Frame auf. Mit diesem Ereignis können Sie bestimmen, wie lange jeder Frame zum Rendern benötigt. |
| Rendering |
Tritt auf, wenn der Kernrenderingprozess einen Frame rendert. |
| SurfaceContentsLost |
Tritt auf, wenn eine zugrunde liegende wesentliche Ä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. |