VirtualizingLayoutContext.GetOrCreateElementAt Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| GetOrCreateElementAt(Int32) |
Recupera um UIElement que representa o item de dados na fonte encontrada no índice especificado. Por padrão, se um elemento já existir, ele será retornado; caso contrário, um novo elemento será criado. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows). |
| GetOrCreateElementAt(Int32, ElementRealizationOptions) |
Recupera um UIElement que representa o item de dados na fonte encontrada no índice especificado usando as opções especificadas. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows). |
GetOrCreateElementAt(Int32)
Recupera um UIElement que representa o item de dados na fonte encontrada no índice especificado. Por padrão, se um elemento já existir, ele será retornado; caso contrário, um novo elemento será criado.
Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo 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
O índice do item de dados para o qual recuperar um UIElement.
Retornos
Um UIElement que representa o item de dados.
- Atributos
Comentários
Esse método chama GetOrCreateElementAtCore(System.Int32,Microsoft.UI.Xaml.Controls.ElementRealizationOptions) com opções definidas como None.
GetElementAtCore deve ser implementado em uma classe derivada.
Aplica-se a
GetOrCreateElementAt(Int32, ElementRealizationOptions)
Recupera um UIElement que representa o item de dados na fonte encontrada no índice especificado usando as opções especificadas.
Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo 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
O índice do item de dados para o qual recuperar um UIElement.
- options
- ElementRealizationOptions
Um valor de ElementRealizationOptions que especifica se é necessário suprimir a reciclagem automática do elemento recuperado ou forçar a criação de um novo elemento.
Retornos
Um UIElement que representa o item de dados.
- Atributos
Comentários
Esse método chama GetOrCreateElementAtCore(System.Int32,Microsoft.UI.Xaml.Controls.ElementRealizationOptions), que deve ser implementado em uma classe derivada.
Ao solicitar um elemento para o índice especificado, você pode opcionalmente especificar se deseja suprimir a reciclagem automática do elemento recuperado ou forçar a criação de um novo elemento. Os elementos recuperados com a reciclagem automática suprimida (SuppressAutoRecycle) são ignorados pela lógica de reciclagem automática que limpa elementos realizados que não foram recuperados como parte da passagem de layout atual. Você deve reciclar explicitamente esses elementos passando-os para o método RecycleElement para evitar vazamentos de memória.
Essas opções destinam-se a layouts mais avançados que optam por gerenciar explicitamente a realização e a reciclagem de elementos como uma otimização de desempenho.