CompositionTarget.Rendering Evento
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Se produce cuando el proceso de representación principal representa un marco.
// Register
static event_token Rendering(EventHandler<IInspectable> const& handler) const;
// Revoke with event_token
static void Rendering(event_token const* cookie) const;
// Revoke with event_revoker
static CompositionTarget::Rendering_revoker Rendering(auto_revoke_t, EventHandler<IInspectable> const& handler) const;public static event System.EventHandler<object> Rendering;function onRendering(eventArgs) { /* Your code */ }
Microsoft.UI.Xaml.Media.CompositionTarget.addEventListener("rendering", onRendering);
Microsoft.UI.Xaml.Media.CompositionTarget.removeEventListener("rendering", onRendering);
- or -
Microsoft.UI.Xaml.Media.CompositionTarget.onrendering = onRendering;Public Shared Custom Event Rendering As EventHandler(Of Object) Tipo de evento
Comentarios
Controlar la representación puede ser útil si tiene escenarios de interoperabilidad con Microsoft contenido de DirectX. Por ejemplo, es posible que quieras saber cuándo el marco XAML está representando un marco y sincronizarlo con tu Microsoft contenido generado por DirectX en un SwapChainPanel o SurfaceImageSource para que las actualizaciones visuales se presenten a la pantalla al mismo tiempo. Para obtener más información, consulta Interoperabilidad xaml y DirectX.
Para satisfacer el compilador, el segundo parámetro e/del controlador para un evento Rendering debe ser Object. No use EventArgs. Sin embargo, dentro del controlador, puede convertir la referencia de e/args como RenderingEventArgs. RenderingEventArgs tiene una propiedad RenderingTime que podría ser útil en el escenario de representación, pero no todos los controladores necesitarían esta información. Puede ser suficiente saber que el evento se desencadena y controla cada aparición.
Los controladores para la representación se ejecutan en el subproceso de interfaz de usuario aunque no estén vinculados a ningún elemento de interfaz de usuario específico. Esto es similar a ejecutar una animación infinita. Normalmente, el subproceso de interfaz de usuario solo está activo cuando hay trabajo que hacer, pero agregar un controlador para este evento lo obliga a ejecutar cada fotograma que pueda evitar optimizaciones de uso de energía del sistema. Por lo tanto, es recomendable quitar los controladores de representación cuando ya no los necesite y agregarlos solo cuando los necesite. Por ejemplo, agregue el controlador solo cuando se carguen páginas específicas con contenido directX sincronizado y, a continuación, quite el controlador como parte de la limpieza de páginas (Page.OnNavigatedFrom). Para obtener más información, consulte la sección Uso de animaciones infinitas con moderación de la guía de rendimiento.