FrameworkElement.TemplatedParent プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
この要素のテンプレート親への参照を取得します。 このプロパティは、要素がテンプレートを使用して作成されていない場合は関係ありません。
public:
property System::Windows::DependencyObject ^ TemplatedParent { System::Windows::DependencyObject ^ get(); };
public System.Windows.DependencyObject TemplatedParent { get; }
member this.TemplatedParent : System.Windows.DependencyObject
Public ReadOnly Property TemplatedParent As DependencyObject
プロパティ値
この要素を作成 FrameworkTemplateVisualTree 原因となった要素。 この値は、頻繁に null。
注釈
TemplatedParent は、アプリケーションマークアップまたはコードで作成されたオブジェクトに対して頻繁に null されます。 これは、テンプレートではなく、これらのオブジェクトを直接作成するためです。 ルートから論理ツリーをウォークするか、または一般的な名前参照によって取得されたオブジェクト参照は、テンプレートから取得されません。
TemplatedParentがnullされない場合には、ヒット テスト、特定の低レベルの入力イベントのイベント処理、VisualTreeHelperを使用したビジュアル ツリーのウォーク、列挙子の操作などの操作が含まれます。これは、テンプレートから取得された要素を返す可能性があります。 もう 1 つのケースは、既存のFrameworkTemplateに対してFindNameを明示的に呼び出し、返されたオブジェクトを操作する場合です。
テンプレートは実際には共有オブジェクトであり、テンプレートの内容は 1 回だけ作成されます。 したがって、テンプレートから取得された要素へのオブジェクト参照を取得すると、見かけ上の論理ツリーがページ ルートに到達しないことがあります。 このようなテンプレート参照をページの論理ツリーに接続するには、 TemplatedParent 値を取得し、必要に応じてその要素ツリー内を移動し続ける必要があります。