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 UIElement recuperato in precedenza usando 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
Requisiti Windows
| Famiglia di dispositivi |
Windows 10, version 1809 (è stato introdotto in 10.0.17763.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (è stato introdotto in v7.0)
|
Commenti
Il metodo RecycleElement viene usato per impostare un elemento da parte per il riutilizzo successivo, ma non reimposta automaticamente lo stato corrente dell'elemento. Ad esempio, se lo sfondo di un controllo è 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 nessuno viene trovato, creerà una nuova istanza usando LoadContent.
Il riciclo di un elemento potrebbe non causare immediatamente la rimozione dall'albero degli elementi live. In tale situazione gli eventi caricati/ non vengono generati a meno che non venga aggiunto a un elemento padre diverso nell'albero live.
Se si chiama RecycleElement, non è necessario specificare padre . Tuttavia, è consigliabile usare per abilitare un'ottimizzazione delle prestazioni. Quando GetElement viene chiamato con un valore Padre , cercherà elementi che vengono riciclati per lo stesso elemento Padre. Se sono ancora collegati all'elemento padre, possono essere riutilizzati senza incorrere nel sovraccarico aggiuntivo dell'elemento padre.
Nota
RecycleElement non esclude automaticamente l'elemento riciclato dalla partecipazione all'ordine di tabulazione. Né nasconde il peer di automazione dell'elemento dall'essere visualizzato nell'albero di automazione. I controlli di virtualizzazione predefiniti della piattaforma gestiscono questo controllo per gli elementi sotto il controllo.
Se si sta creando un controllo di virtualizzazione personalizzato da zero o chiamando RecycleElement in scenari uno-off, tenere presente che è responsabilità escludere 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 dei relativi elementi GetChildrenCore ed escludere elementi riciclati.