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

注釈

このメソッドは、オプションを None に設定して 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 メソッドに渡して明示的にリサイクルする必要があります。

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