VirtualizingLayoutContext.GetOrCreateElementAt Método

Definição

Namespace:

Microsoft.UI.Xaml.Controls

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.
GetOrCreateElementAt(Int32, ElementRealizationOptions)	Recupera um UIElement que representa o item de dados na fonte encontrada no índice especificado usando as opções especificadas.

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.

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);

function getOrCreateElementAt(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

UIElement

Um UIElement que representa o item de dados.

Atributos

OverloadAttribute

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.

GetOrCreateElementAt(Int32, ElementRealizationOptions)

Recupera um UIElement que representa o item de dados na fonte encontrada no índice especificado usando as opções especificadas.

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);

function getOrCreateElementAt(index, 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

UIElement

Um UIElement que representa o item de dados.

Atributos

OverloadAttribute

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 os 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.