VirtualizingLayoutContext.GetOrCreateElementAt Метод

Определение

Пространство имен:

Microsoft.UI.Xaml.Controls

Перегрузки

GetOrCreateElementAt(Int32)	Извлекает элемент UIElement, представляющий элемент данных в источнике, найденном по указанному индексу. По умолчанию, если элемент уже существует, он возвращается; в противном случае создается новый элемент. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
GetOrCreateElementAt(Int32, ElementRealizationOptions)	Извлекает элемент UIElement, представляющий элемент данных в источнике, найденном по указанному индексу, с помощью указанных параметров. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).

GetOrCreateElementAt(Int32)

Извлекает элемент UIElement, представляющий элемент данных в источнике, найденном по указанному индексу. По умолчанию, если элемент уже существует, он возвращается; в противном случае создается новый элемент.

Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).

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

Параметры

index

Int32

int

Индекс элемента данных, для которого требуется получить uiElement.

Возвращаемое значение

UIElement

Элемент UIElement, представляющий элемент данных.

Атрибуты

OverloadAttribute

Комментарии

Этот метод вызывает GetOrCreateElementAtCore(System.Int32,Microsoft.UI.Xaml.Controls.ElementRealizationOptions) с параметрами, установленными в значение None.

GetElementAtCore должен быть реализован в производном классе.

GetOrCreateElementAt(Int32, ElementRealizationOptions)

Извлекает элемент UIElement, представляющий элемент данных в источнике, найденном по указанному индексу, с помощью указанных параметров.

Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).

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

Параметры

index

Int32

int

Индекс элемента данных, для которого требуется получить uiElement.

options

ElementRealizationOptions

Значение ElementRealizationOptions , указывающее, следует ли подавлять автоматическое повторное использование извлеченного элемента или принудительное создание нового элемента.

Возвращаемое значение

UIElement

Элемент UIElement, представляющий элемент данных.

Атрибуты

OverloadAttribute

Комментарии

Этот метод вызывает Метод GetOrCreateElementAtCore(System.Int32,Microsoft.UI.Xaml.Controls.ElementRealizationOptions),который должен быть реализован в производном классе.

При запросе элемента для указанного индекса при необходимости можно указать, следует ли подавлять автоматическое повторное использование извлеченного элемента или принудительное создание нового элемента. Элементы, полученные с автоматическим перезапуском, подавляются (SuppressAutoRecycle) игнорируются логикой автоматического перезапуска, которая очищает реализованные элементы, которые не были получены в рамках текущего прохода макета. Чтобы избежать утечек памяти, необходимо явно переработать эти элементы, передав их в метод RecycleElement .

Эти параметры предназначены для более сложных макетов, которые выбирают явное управление реализацией и переработкой элементов в качестве оптимизации производительности.