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 .
Эти параметры предназначены для более сложных макетов, которые выбирают явное управление реализацией и переработкой элементов в качестве оптимизации производительности.