Freigeben über


DataTemplate.RecycleElement(ElementFactoryRecycleArgs) Methode

Definition

Verwendet ein UIElement , das zuvor mit GetElement abgerufen wurde.

void RecycleElement(ElementFactoryRecycleArgs const& args);
public void RecycleElement(ElementFactoryRecycleArgs args);
function recycleElement(args)
Public Sub RecycleElement (args As ElementFactoryRecycleArgs)

Parameter

Implementiert

Windows-Anforderungen

Gerätefamilie
Windows 10, version 1809 (eingeführt in 10.0.17763.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v7.0)

Hinweise

Die RecycleElement-Methode wird verwendet, um ein Element zur späteren Wiederverwendung beiseite zu legen, aber der aktuelle Zustand des Elements wird nicht automatisch zurückgesetzt. Wenn beispielsweise der Hintergrund eines Steuerelements programmgesteuert festgelegt wird, wird der Wert beibehalten, wenn er der Livestruktur erneut hinzugefügt wird.

Von GetElement zurückgegebene wiederverwendete Elemente können der Livestruktur auf die gleiche Weise wie neu erstellte Elemente hinzugefügt werden.

GetElement versucht, eine vorhandene instance von den wiederverwendeten abzurufen. Wenn keine gefunden wird, wird mithilfe von LoadContent eine neue instance erstellt.

Das Recycling eines Elements führt möglicherweise nicht sofort dazu, dass es aus der Aktiven Elementstruktur entfernt wird. In dieser Situation werden die Unloaded/Loaded-Ereignisse nur ausgelöst, wenn sie einem anderen übergeordneten Element in der Livestruktur hinzugefügt werden.

Die Angabe des übergeordneten Elements ist beim Aufrufen von RecycleElement nicht erforderlich. Seine Verwendung wird jedoch empfohlen, um eine Leistungsoptimierung zu aktivieren. Wenn GetElement mit einem Parent-Wert aufgerufen wird, sucht es nach Elementen, die für dasselbe Übergeordnete Element wiederverwendet wurden. Wenn sie weiterhin an das übergeordnete Element angefügt sind, können sie wiederverwendet werden, ohne dass der zusätzliche Mehraufwand für das erneute Übergeordnete des Elements entsteht.

Hinweis

RecycleElement schließt das wiederverwendete Element nicht automatisch von der Teilnahme an der Aktivierreihenfolge aus. Es wird auch nicht ausgeblendet, dass der Automatisierungspeer des Elements in der Automatisierungsstruktur angezeigt wird. Die integrierten Virtualisierungssteuerelemente der Plattform verwalten dies für die Elemente unter ihrer Kontrolle.

Wenn Sie ein benutzerdefiniertes Virtualisierungssteuerelement von Grund auf neu erstellen oder RecycleElement in einmaligen Szenarien aufrufen, sollten Sie sich bewusst sein, dass Sie dafür verantwortlich sind, wiederverwendete Elemente aus der Aktivierreihenfolge und der Struktur der Automatisierungspeer auszuschließen.

Sie können GetChildrenInTabFocusOrder überschreiben und die Teilmenge der realisierten Elemente angeben, die das Framework für den Tab-Fokus verwenden sollte. Auf ähnliche Weise sollte der Automatisierungspeer für das Steuerelement seine GetChildrenCore-Instanz außer Kraft setzen und wiederverwendete Elemente ausschließen.

Gilt für:

Weitere Informationen