VirtualizingLayoutContext.GetOrCreateElementAt Método

Definición

Espacio de nombres:

Microsoft.UI.Xaml.Controls

Sobrecargas

GetOrCreateElementAt(Int32)	Recupera un UIElement que representa el elemento de datos del origen que se encuentra en el índice especificado. De forma predeterminada, si ya existe un elemento, se devuelve; de lo contrario, se crea un nuevo elemento. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
GetOrCreateElementAt(Int32, ElementRealizationOptions)	Recupera un UIElement que representa el elemento de datos del origen que se encuentra en el índice especificado mediante las opciones especificadas. Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

GetOrCreateElementAt(Int32)

Recupera un UIElement que representa el elemento de datos del origen que se encuentra en el índice especificado. De forma predeterminada, si ya existe un elemento, se devuelve; de lo contrario, se crea un nuevo elemento.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

public:
 virtual UIElement ^ GetOrCreateElementAt(int index) = GetOrCreateElementAt;

/// [Windows.Foundation.Metadata.Overload("GetOrCreateElementAt")]
UIElement GetOrCreateElementAt(int const& index);

[Windows.Foundation.Metadata.Overload("GetOrCreateElementAt")]
public UIElement GetOrCreateElementAt(int index);

Public Function GetOrCreateElementAt (index As Integer) As UIElement

Parámetros

index

Int32

int

Índice del elemento de datos para el que se va a recuperar un uiElement.

Devoluciones

UIElement

UiElement que representa el elemento de datos.

Atributos

OverloadAttribute

Comentarios

Este método llama a GetOrCreateElementAtCore(System.Int32,Microsoft.UI.Xaml.Controls.ElementRealizationOptions) con las opciones establecidas en None.

GetElementAtCore debe implementarse en una clase derivada.

GetOrCreateElementAt(Int32, ElementRealizationOptions)

Recupera un UIElement que representa el elemento de datos del origen que se encuentra en el índice especificado mediante las opciones especificadas.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

public:
 virtual UIElement ^ GetOrCreateElementAt(int index, ElementRealizationOptions options) = GetOrCreateElementAt;

/// [Windows.Foundation.Metadata.Overload("GetOrCreateElementAt2")]
UIElement GetOrCreateElementAt(int const& index, ElementRealizationOptions const& options);

[Windows.Foundation.Metadata.Overload("GetOrCreateElementAt2")]
public UIElement GetOrCreateElementAt(int index, ElementRealizationOptions options);

Public Function GetOrCreateElementAt (index As Integer, options As ElementRealizationOptions) As UIElement

Parámetros

index

Int32

int

Índice del elemento de datos para el que se va a recuperar un uiElement.

options

ElementRealizationOptions

Valor de ElementRealizationOptions que especifica si se debe suprimir el reciclaje automático del elemento recuperado o forzar la creación de un nuevo elemento.

Devoluciones

UIElement

UiElement que representa el elemento de datos.

Atributos

OverloadAttribute

Comentarios

Este método llama a GetOrCreateElementAtCore(System.Int32,Microsoft.UI.Xaml.Controls.ElementRealizationOptions), que se debe implementar en una clase derivada.

Si solicita un elemento para el índice especificado, puede especificar opcionalmente si desea suprimir el reciclaje automático del elemento recuperado o forzar la creación de un nuevo elemento. Los elementos recuperados con el reciclaje automático suprimido (SuppressAutoRecycle) se omiten mediante la lógica de reciclaje automático que borra los elementos realizados que no se recuperaron como parte del pase de diseño actual. Debe reciclar explícitamente estos elementos pasándolos al método RecycleElement para evitar pérdidas de memoria.

Estas opciones están pensadas para diseños más avanzados que eligen administrar explícitamente la realización y el reciclaje de elementos como una optimización del rendimiento.