DataTemplate.GetElement(ElementFactoryGetArgs) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
DataTemplate で宣言された UIElement オブジェクトの既存のインスタンスを作成または取得します。
UIElement GetElement(ElementFactoryGetArgs const& args);
public UIElement GetElement(ElementFactoryGetArgs args);
function getElement(args)
Public Function GetElement (args As ElementFactoryGetArgs) As UIElement
パラメーター
ElementFactoryGetArgs のインスタンス。
戻り値
DataTemplate で宣言されたルート UIElement のインスタンス。 DataTemplate のルートが UIElement でない場合は null 。
実装
Windows の要件
デバイス ファミリ |
Windows 10, version 1809 (10.0.17763.0 で導入)
|
API contract |
Windows.Foundation.UniversalApiContract (v7.0 で導入)
|
注釈
DataTemplate は、テンプレートで宣言された要素オブジェクトを生成するファクトリとして機能します。 呼び出されるたびに新しいインスタンスを作成する LoadContent メソッドとは異なり、GetElement メソッドは、新しいインスタンスを作成するか、 RecycleElement 経由でリサイクルされた既存のインスタンスを返すことができます。
DataTemplate の GetElement の実装では、ElementFactoryGetArgs の Data 値は使用されません。 Data プロパティは、DataTemplateSelector などの実装用に存在します。このプロパティは、コンテンツを読み込む DataTemplate の決定に使用されます。