VirtualizingLayoutContext.GetOrCreateElementAt メソッド

定義

名前空間:

Microsoft.UI.Xaml.Controls

オーバーロード

GetOrCreateElementAt(Int32)	指定したインデックスにあるソース内のデータ項目を表す UIElement を取得します。 既定では、要素が既に存在する場合は返されます。それ以外の場合は、新しい要素が作成されます。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI については、Windows アプリ SDK名前空間を参照してください)。
GetOrCreateElementAt(Int32, ElementRealizationOptions)	指定したオプションを使用して、指定したインデックスにあるソース内のデータ項目を表す UIElement を取得します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI については、Windows アプリ SDK名前空間を参照してください)。

GetOrCreateElementAt(Int32)

指定したインデックスにあるソース内のデータ項目を表す UIElement を取得します。 既定では、要素が既に存在する場合は返されます。それ以外の場合は、新しい要素が作成されます。

このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI については、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 アプリ SDKの WinUI については、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 メソッドに渡して明示的にリサイクルする必要があります。

これらのオプションは、パフォーマンスの最適化として要素の実現とリサイクルを明示的に管理することを選択する、より高度なレイアウトを対象としています。