CompositionTarget.Rendered Evento
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Ocorre imediatamente após o processo de renderização principal renderizar um quadro. Esse evento permite determinar quanto tempo cada quadro leva para renderizar.
// Register
static event_token Rendered(EventHandler<RenderedEventArgs> const& handler) const;
// Revoke with event_token
static void Rendered(event_token const* cookie) const;
// Revoke with event_revoker
static CompositionTarget::Rendered_revoker Rendered(auto_revoke_t, EventHandler<RenderedEventArgs> const& handler) const;
public static event System.EventHandler<RenderedEventArgs> Rendered;
function onRendered(eventArgs) { /* Your code */ }
Windows.UI.Xaml.Media.CompositionTarget.addEventListener("rendered", onRendered);
Windows.UI.Xaml.Media.CompositionTarget.removeEventListener("rendered", onRendered);
- or -
Windows.UI.Xaml.Media.CompositionTarget.onrendered = onRendered;
Public Shared Custom Event Rendered As EventHandler(Of RenderedEventArgs)
Tipo de evento
Requisitos do Windows
Família de dispositivos |
Windows 10, version 1803 (introduzida na 10.0.17134.0)
|
API contract |
Windows.Foundation.UniversalApiContract (introduzida na v6.0)
|
Comentários
Dica
Recomendamos que você use o criador de perfil da Linha do Tempo do Aplicativo do Visual Studio ao desenvolver e testar seu aplicativo. Ele fornece informações mais detalhadas sobre o consumo de recursos do aplicativo, incluindo o tempo gasto na preparação de quadros de interface do usuário.
Você pode usar o evento Renderizado para medir a duração do quadro e a capacidade de resposta do aplicativo em runtime sem o Visual Studio ou um depurador anexado. Por exemplo, isso pode ser usado para gerar telemetria para aplicativos depois que eles são implantados ou para ajustar a quantidade de trabalhos personalizados de renderização DirectX que um aplicativo está fazendo a cada quadro.
Uma duração de quadro mais longa significa que seu aplicativo teve que executar mais trabalho antes que um quadro pudesse ser renderizado. Durações de quadro maiores que aproximadamente 16 milissegundos significam que seu aplicativo não é capaz de atualizar na frequência recomendada de 60 quadros por segundo e, portanto, o usuário pode enfrentar um atraso perceptível na capacidade de resposta da interface do usuário.
Se você vir durações de quadros longos, considere a criação de perfil do aplicativo usando a Linha do Tempo do Aplicativo do Visual Studio e a implementação das melhores práticas de desempenho recomendadas.
Os manipuladores para Renderizados são executados no thread da interface do usuário, embora não estejam vinculados a nenhum elemento de interface do usuário específico. É uma boa ideia remover todos os manipuladores renderizados quando você não precisar mais deles e adicioná-los somente quando precisar deles.