VirtualizingLayoutContext.GetOrCreateElementAt 메서드

정의

네임스페이스:

Microsoft.UI.Xaml.Controls

오버로드

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

GetOrCreateElementAt(Int32)

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

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);

function getOrCreateElementAt(index)

Public Function GetOrCreateElementAt (index As Integer) As UIElement

매개 변수

index

Int32

int

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

반환

UIElement

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

특성

OverloadAttribute

설명

이 메서드는 옵션이 없음으로 설정된 GetOrCreateElementAtCore(System.Int32,Microsoft.UI.Xaml.Controls.ElementRealizationOptions)를 호출합니다.

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

GetOrCreateElementAt(Int32, ElementRealizationOptions)

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

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);

function getOrCreateElementAt(index, 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 메서드에 전달하여 이러한 요소를 명시적으로 재활용해야 합니다.

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