VirtualizingLayoutContext.GetOrCreateElementAt Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 UIElementParámetros
- index
-
Int32
int
Índice del elemento de datos para el que se va a recuperar un uiElement.
Devoluciones
UiElement que representa el elemento de datos.
- Atributos
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.
Se aplica a
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 UIElementPará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 que representa el elemento de datos.
- Atributos
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.