CompositionTarget Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.UI.Xaml.Media

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Rappresenta l'area di visualizzazione composita per un'app. Questa classe fornisce eventi di rendering a livello di applicazione.

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

Ereditarietà: Object Platform::Object IInspectable CompositionTarget

Attributi: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

Gli eventi CompositionTarget sono utili per i rendering di scenari come:

sincronizzazione del rendering dell'interoperabilità DirectX tramite l'evento Rendering
misurazione del tempo di rendering del frame usando l'evento Di rendering
rigenerando contenuto visivo personalizzato sullo schermo in risposta all'evento SurfaceContentsLost , ad esempio rigenerando un contenuto di interoperabilità RenderTargetBitmap o DirectX in surfaceImageSource

Per gli scenari che non coinvolgono il rendering personalizzato o la misurazione del tempo di frame, probabilmente non è necessario CompositionTarget e può solo basarsi sul sistema di rendering XAML in esecuzione ed eseguire tutte le operazioni di composizione e layout.

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
1803	17134	Rendering

Eventi

Rendered	Si verifica immediatamente dopo il rendering del processo di rendering principale che esegue il rendering di un frame. Questo evento consente di determinare il tempo necessario per il rendering di ogni frame.
Rendering	Si verifica quando il processo di rendering principale esegue il rendering di un frame.
SurfaceContentsLost	Si verifica quando si verifica una modifica principale sottostante, ad esempio una modifica del dispositivo DirectX. In genere l'applicazione deve rigenerare il contenuto della superficie quando si riceve una notifica di questo evento.

Si applica a