Compartir a través de


DataTemplate.RecycleElement(ElementFactoryRecycleArgs) Método

Definición

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

Implementaciones

Requisitos de Windows

Familia de dispositivos
Windows 10, version 1809 (se introdujo en la versión 10.0.17763.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v7.0)

Comentarios

El método RecycleElement se usa para reservar un elemento para volver a usar 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 desde 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 no puede hacer que se quite inmediatamente del árbol de elementos activos. En esa situación, los eventos Unloaded/Loaded no se generan a menos que se agregue a otro elemento primario del á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 Primario , buscará 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 el 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 llamando a RecycleElement en escenarios puntuales, tenga en cuenta que es su responsabilidad excluir los 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 elementos reciclados.

Se aplica a

Consulte también