CompositionTarget Classe
Definizione
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.
Rappresenta la superficie 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(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- Ereditarietà
- Attributi
Commenti
Gli eventi CompositionTarget sono utili per scenari di rendering come:
sincronizzazione del rendering dell'interoperabilità DirectX tramite l'evento Rendering
misurazione del tempo di rendering dei fotogrammi tramite l'evento Sottoposto a rendering
rigenerazione del 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 implicano il rendering personalizzato o la misurazione del tempo di fotogramma, probabilmente non è necessario CompositionTarget e può semplicemente basarsi sul sistema di rendering XAML in esecuzione ed eseguire tutta la composizione e il layout.
Metodi
| Nome | Descrizione |
|---|---|
| GetCompositorForCurrentThread() |
Recupera l'oggetto Compositor per questo thread. |
Eventi
| Nome | Descrizione |
|---|---|
| Rendered |
Si verifica immediatamente dopo il rendering del processo di rendering principale di un frame. Questo evento consente di determinare il tempo necessario per il rendering di ogni fotogramma. |
| Rendering |
Si verifica quando il processo di rendering principale esegue il rendering di un frame. |
| SurfaceContentsLost |
Si verifica quando si verifica una modifica importante sottostante, ad esempio una modifica del dispositivo DirectX. In genere, l'applicazione deve rigenerare il contenuto della superficie quando riceve una notifica di questo evento. |