Compartilhar via


VirtualizingLayoutContext.GetOrCreateElementAt Método

Definição

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 UIElement

Parâ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 UIElement

Parâ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.

Aplica-se a