VirtualizingLayoutContext.GetOrCreateElementAt 메서드

정의

네임스페이스:

Microsoft.UI.Xaml.Controls

오버로드

GetOrCreateElementAt(Int32)	지정된 인덱스에 있는 원본의 데이터 항목을 나타내는 UIElement를 검색합니다. 기본적으로 요소가 이미 있으면 반환됩니다. 그렇지 않으면 새 요소가 만들어집니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
GetOrCreateElementAt(Int32, ElementRealizationOptions)	지정된 옵션을 사용하여 지정된 인덱스에 있는 원본의 데이터 항목을 나타내는 UIElement를 검색합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

GetOrCreateElementAt(Int32)

지정된 인덱스에 있는 원본의 데이터 항목을 나타내는 UIElement를 검색합니다. 기본적으로 요소가 이미 있으면 반환됩니다. 그렇지 않으면 새 요소가 만들어집니다.

이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 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

설명

이 메서드는 None으로 설정된 옵션을 사용하여 GetOrCreateElementAtCore(System.Int32,Microsoft.UI.Xaml.Controls.ElementRealizationOptions)를 호출합니다.

GetElementAtCore는 파생 클래스에서 구현되어야 합니다.

GetOrCreateElementAt(Int32, ElementRealizationOptions)

지정된 옵션을 사용하여 지정된 인덱스에 있는 원본의 데이터 항목을 나타내는 UIElement를 검색합니다.

이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 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 메서드에 전달하여 명시적으로 재활용해야 합니다.

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