VirtualizingLayoutContext.GetOrCreateElementAtCore Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft bei der Implementierung in einer abgeleiteten Klasse ein UIElement ab, das das Datenelement in der Quelle darstellt, die im angegebenen Index gefunden wird, indem die angegebenen Optionen verwendet werden.
Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
protected:
virtual UIElement ^ GetOrCreateElementAtCore(int index, ElementRealizationOptions options) = GetOrCreateElementAtCore;UIElement GetOrCreateElementAtCore(int const& index, ElementRealizationOptions const& options);protected virtual UIElement GetOrCreateElementAtCore(int index, ElementRealizationOptions options);Protected Overridable Function GetOrCreateElementAtCore (index As Integer, options As ElementRealizationOptions) As UIElementParameter
- index
-
Int32
int
Der Index des Datenelements, für das ein UIElement abgerufen werden soll.
- options
- ElementRealizationOptions
Gibt an, ob das automatische Recycling des abgerufenen Elements unterdrückt oder die Erstellung eines neuen Elements erzwungen werden soll.
Gibt zurück
Ein UIElement , das das Datenelement darstellt.
Hinweise
Diese Methode wird von GetOrCreateElementAt(System.Int32) und GetOrCreateElementAt(System.Int32,Microsoft.UI.Xaml.Controls.ElementRealizationOptions) aufgerufen.
Wenn Sie ein Element für den angegebenen Index anfordern, können Sie optional angeben, ob das automatische Recycling des abgerufenen Elements unterdrückt oder die Erstellung eines neuen Elements erzwungen werden soll. Elemente, die mit dem automatischen Recycling unterdrückt (SuppressAutoRecycle) abgerufen werden, werden von der automatischen Recyclinglogik ignoriert, die realisierte Elemente löscht, die nicht als Teil des aktuellen Layoutdurchlaufs abgerufen wurden. Sie müssen diese Elemente explizit wiederverwenden, indem Sie sie an die RecycleElementCore(Windows.UI.Xaml.UIElement)- Methode übergeben, um Speicherverluste zu vermeiden.
Diese Optionen sind für erweiterte Layouts vorgesehen, bei denen die Realisierung und das Recycling von Elementen als Leistungsoptimierung explizit verwaltet werden sollen.