-api-id | -api-type |
---|---|
T:Microsoft.UI.Xaml.Controls.ElementRealizationOptions |
winrt enum |
Defines constants that specify whether to suppress automatic recycling of the retrieved element or force creation of a new element.
Creation of a new element is forced.
No option is specified.
The element is ignored by the automatic recycling logic.
When you call GetOrCreateElementAt(index, options), you can specify whether to suppress automatic recycling of the retrieved element or force creation of a new element. Elements retrieved with automatic recycling suppressed (SuppressAutoRecycle) are ignored by the automatic recycling logic that clears realized elements that were not retrieved as part of the current layout pass. You must explicitly recycle these elements by passing them to the RecycleElement method to avoid memory leaks.