VirtualizingLayoutContext.GetOrCreateElementAtCore 메서드

정의

네임스페이스:

Microsoft.UI.Xaml.Controls

파생 클래스에서 구현되는 경우 지정된 옵션을 사용하여 지정된 인덱스에 있는 원본의 데이터 항목을 나타내는 UIElement 를 검색합니다.

이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

protected:
 virtual UIElement ^ GetOrCreateElementAtCore(int index, ElementRealizationOptions options) = GetOrCreateElementAtCore;

UIElement GetOrCreateElementAtCore(int const& index, ElementRealizationOptions const& options);

protected virtual UIElement GetOrCreateElementAtCore(int index, ElementRealizationOptions options);

Protected Overridable Function GetOrCreateElementAtCore (index As Integer, options As ElementRealizationOptions) As UIElement

매개 변수

index

Int32

int

UIElement를 검색할 데이터 항목의 인덱스입니다.

options

ElementRealizationOptions

검색된 요소의 자동 재활용을 억제할지 또는 새 요소를 강제로 만들지 여부를 지정합니다.

반환

UIElement

데이터 항목을 나타내는 UIElement 입니다.

설명

이 메서드는 GetOrCreateElementAt(System.Int32) 및 GetOrCreateElementAt(System.Int32,Microsoft.UI.Xaml.Controls.ElementRealizationOptions)에서 호출됩니다.

지정된 인덱스의 요소를 요청할 때 검색된 요소의 자동 재활용을 억제할지 또는 새 요소를 강제로 만들지 여부를 선택적으로 지정할 수 있습니다. 자동 재활용을 억제(SuppressAutoRecycle)하여 검색된 요소는 현재 레이아웃 단계의 일부로 검색되지 않은 실현된 요소를 지우는 자동 재활용 논리에서 무시됩니다. 메모리 누수 방지를 위해 이러한 요소를 RecycleElementCore(Windows.UI.Xaml.UIElement) 메서드에 전달하여 명시적으로 재활용해야 합니다.

이러한 옵션은 성능 최적화로 요소의 실현 및 재활용을 명시적으로 관리하도록 선택하는 고급 레이아웃을 위한 것입니다.