DataTemplate.RecycleElement(ElementFactoryRecycleArgs) Metodo
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.
Ricicla un oggetto UIElement recuperato in precedenza tramite GetElement.
void RecycleElement(ElementFactoryRecycleArgs const& args);public void RecycleElement(ElementFactoryRecycleArgs args);function recycleElement(args)Public Sub RecycleElement (args As ElementFactoryRecycleArgs)Parametri
Istanza di ElementFactoryRecycleArgs.
Implementazioni
Commenti
Il metodo RecycleElement viene utilizzato per riservare un elemento per un riutilizzo successivo, ma non reimposta automaticamente lo stato corrente dell'elemento. Ad esempio, se lo sfondo di uncontrollo viene impostato a livello di codice, il valore persiste quando viene aggiunto di nuovo all'albero attivo.
Gli elementi riciclati restituiti da GetElement possono essere aggiunti all'albero attivo nello stesso modo degli elementi appena creati.
GetElement tenta di recuperare un'istanza esistente da quelle riciclate. Se non viene trovato alcuno, verrà creata una nuova istanza usando LoadContent.
Il riciclo di un elemento potrebbe non causare immediatamente la rimozione dall'albero degli elementi attivi. In tal caso, gli eventi Unloaded Loaded/ non vengono generati a meno che non venga aggiunto a un elemento padre diverso nell'albero live.
Quando si chiama RecycleElement, non è necessario specificare l'elemento padre . Tuttavia, è consigliabile usarlo per abilitare un'ottimizzazione delle prestazioni. Quando GetElement viene chiamato con un valore Parent , cercherà gli elementi che vengono riciclati per lo stesso elemento Parent. Se sono ancora collegati all'elemento padre, possono essere riutilizzati senza incorrere nell'overhead aggiuntivo di ri-padre dell'elemento.
Note
RecycleElement non esclude automaticamente l'elemento riciclato dalla partecipazione all'ordine di tabulazione. Né nasconde la visualizzazione del peer di automazione dell'elemento nell'albero di automazione. I controlli di virtualizzazione predefiniti della piattaforma gestiscono questo controllo per gli elementi sotto il relativo controllo.
Se si sta creando un controllo di virtualizzazione personalizzato da zero o chiamando RecycleElement in scenari uno-off, tenere presente che è responsabilità dell'utente escludere gli elementi riciclati dall'ordine di tabulazione e dall'albero dei peer di automazione.
È possibile eseguire l'override di GetChildrenInTabFocusOrder e fornire il subset di elementi realizzati che il framework deve usare per lo stato attivo tabulazione. Analogamente, il peer di automazione per il controllo deve eseguire l'override di GetChildrenCore ed escludere elementi riciclati.