DataTemplate.RecycleElement(ElementFactoryRecycleArgs) Metodo

Riferimento

Definizione

Spazio dei nomi:: Windows.UI.Xaml

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.

Modifica

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

args: ElementFactoryRecycleArgs

Istanza di ElementFactoryRecycleArgs.

Implementazioni

RecycleElement(ElementFactoryRecycleArgs)

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.

Si applica a