Поделиться через


VirtualizingLayoutContext.GetOrCreateElementAt Метод

Определение

Перегрузки

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, представляющий элемент данных.

Атрибуты

Комментарии

Этот метод вызывает 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, представляющий элемент данных.

Атрибуты

Комментарии

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

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

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

Применяется к