DataTemplate.RecycleElement(ElementFactoryRecycleArgs) Método
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í.
Recicla un UIElement que se recuperó anteriormente mediante GetElement.
void RecycleElement(ElementFactoryRecycleArgs const& args);public void RecycleElement(ElementFactoryRecycleArgs args);function recycleElement(args)Public Sub RecycleElement (args As ElementFactoryRecycleArgs)Parámetros
Instancia de ElementFactoryRecycleArgs.
Implementaciones
Comentarios
El método RecycleElement se usa para reservar un elemento para volver a usarse posteriormente, pero no restablece automáticamente el estado actual del elemento. Por ejemplo, si el fondo de un control se establece mediante programación, el valor persiste cuando se agrega al árbol activo de nuevo.
Los elementos reciclados devueltos de GetElement se pueden agregar al árbol activo de la misma manera que los elementos recién creados.
GetElement intenta recuperar una instancia existente de las que se reciclaron. Si no se encuentra ninguno, creará una nueva instancia mediante LoadContent.
El reciclaje de un elemento puede no provocar que se quite inmediatamente del árbol de elementos dinámicos. En esa situación, los eventos Cargados descargados/ no se generan a menos que se agregue a un elemento primario diferente en el árbol activo.
No es necesario especificar el elemento primario al llamar a RecycleElement. Sin embargo, se recomienda su uso para habilitar una optimización del rendimiento. Cuando se llama a GetElement con un valor Parent , buscará los elementos que se reciclan para ese mismo elemento Primario. Si todavía están conectados al elemento primario, se pueden volver a usar sin incurrir en la sobrecarga adicional de volver a crear la primaria del elemento.
Nota
RecycleElement no excluye automáticamente el elemento reciclado de participar en el orden de tabulación. Tampoco oculta la automatización del elemento del mismo nivel que aparece en el árbol de automatización. Los controles de virtualización integrados de la plataforma administran esto para los elementos bajo su control.
Si va a crear un control de virtualización personalizado desde cero o llamar a RecycleElement en escenarios puntuales, tenga en cuenta que es su responsabilidad excluir elementos reciclados del orden de tabulación y el árbol de elementos del mismo nivel de automatización.
Puede invalidar GetChildrenInTabFocusOrder y proporcionar el subconjunto de elementos realizados que el marco debe usar para el foco tab. Del mismo modo, el elemento del mismo nivel de automatización para el control debe invalidar sus elementos GetChildrenCore y excluir los elementos reciclados.