VirtualizingLayoutContext.GetOrCreateElementAt メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| 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。
- 属性
注釈
このメソッドは、オプションを 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。
- 属性
注釈
このメソッドは GetOrCreateElementAtCore(System.Int32,Microsoft.UI.Xaml.Controls.ElementRealizationOptions)を呼び出します。これは派生クラスに実装する必要があります。
指定したインデックスの要素を要求するときに、必要に応じて、取得した要素の自動リサイクルを抑制するか、新しい要素を強制的に作成するかを指定できます。 自動リサイクル抑制 (SuppressAutoRecycle) で取得された要素は、現在のレイアウト パスの一部として取得されなかった実現された要素をクリアする自動リサイクル ロジックによって無視されます。 メモリ リークを回避するには、これらの要素を RecycleElement メソッドに渡して明示的にリサイクルする必要があります。
これらのオプションは、パフォーマンスの最適化として要素の実現とリサイクルを明示的に管理することを選択する、より高度なレイアウトを対象としています。