VirtualizingLayoutContext.GetOrCreateElementAtCore メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
protected:
virtual UIElement ^ GetOrCreateElementAtCore(int index, ElementRealizationOptions options) = GetOrCreateElementAtCore;
UIElement GetOrCreateElementAtCore(int const& index, ElementRealizationOptions const& options);
protected virtual UIElement GetOrCreateElementAtCore(int index, ElementRealizationOptions options);
function getOrCreateElementAtCore(index, options)
Protected Overridable Function GetOrCreateElementAtCore (index As Integer, options As ElementRealizationOptions) As UIElement
パラメーター
- options
- ElementRealizationOptions
取得した要素の自動リサイクルを抑制するか、新しい要素を強制的に作成するかを指定します。
戻り値
データ項目を表す UIElement 。
注釈
このメソッドは 、GetOrCreateElementAt(System.Int32) と GetOrCreateElementAt(System.Int32,Microsoft.UI.Xaml.Controls.ElementRealizationOptions) によって呼び出されます。
指定したインデックスの要素を要求するときに、必要に応じて、取得した要素の自動リサイクルを抑制するか、新しい要素を強制的に作成するかを指定できます。 自動リサイクル抑制 (SuppressAutoRecycle) で取得された要素は、現在のレイアウト パスの一部として取得されなかった実現された要素をクリアする自動リサイクル ロジックでは無視されます。 これらの要素は、メモリ リークを回避するために RecycleElementCore(Microsoft.UI.Xaml.UIElement) メソッドに渡すことによって、明示的にリサイクルする必要があります。
これらのオプションは、パフォーマンスの最適化として要素の実現とリサイクルを明示的に管理することを選択する、より高度なレイアウトを対象としています。