FrameworkElement.TemplatedParent Eigenschaft

Definition

Ruft einen Verweis auf die übergeordnete Vorlage dieses Elements ab.Gets a reference to the template parent of this element. Diese Eigenschaft ist nicht relevant, wenn das Element nicht durch eine Vorlage erstellt wurde.This property is not relevant if the element was not created through a template.

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

Eigenschaftswert

Das Element, dessen FrameworkTemplateVisualTree die Erstellung dieses Elements verursacht hat.The element whose FrameworkTemplateVisualTree caused this element to be created. Dieser Wert ist häufig null.This value is frequently null.

Hinweise

TemplatedParent ist häufig null für Objekte, die im Anwendungs Markup oder Code erstellt werden.TemplatedParent is frequently null for objects that are created in your application markup or code. Dies liegt daran, dass Sie diese Objekte direkt und nicht über eine Vorlage erstellen.This is because you create those objects directly, not via a template. Objekt Verweise, die durch das Durchlaufen der logischen Struktur aus dem Stamm oder durch eine typische namens Referenz abgerufen werden, stammen nicht aus einer Vorlage.Object references obtained by walking the logical tree from the root, or by typical name references, do not come from a template.

Fälle, in denen TemplatedParent möglicherweise nicht null sind Vorgänge wie Treffer Tests, Ereignis Behandlung für bestimmte Low-Level-Eingabeereignisse, das Durchlaufen der visuellen Struktur mit VisualTreeHelperoder das Arbeiten mit Enumeratoren, die möglicherweise Elemente zurückgeben, die aus Vorlagen stammen.Cases where TemplatedParent might not be null include operations such as hit-testing, event handling for certain low-level input events, walking the visual tree with VisualTreeHelper, or working with enumerators, which might return elements that came from templates. Ein weiterer Fall ist, wenn Sie FindName speziell für eine vorhandene FrameworkTemplate aufzurufen und mit dem zurückgegebenen Objekt arbeiten.Another case is if you specifically call FindName against an existing FrameworkTemplate and are work with the returned object.

Vorlagen sind tatsächlich freigegebene Objekte, bei denen der Inhalt der Vorlage nur einmal erstellt wird.Templates are actually shared objects, where the contents of the template are created only once. Wenn Sie also einen Objekt Verweis auf ein Element erhalten, das aus einer Vorlage stammt, können Sie feststellen, dass die sichtbare logische Struktur nicht zum Seiten Stamm gelangt.Therefore, if you obtain an object reference to an element that came from a template, you may find that the apparent logical tree does not reach to the page root. Um einen solchen Vorlagen Verweis mit der logischen Struktur der Seite zu verbinden, sollten Sie den TemplatedParent Wert erhalten und weiterhin in der gewünschten Elementstruktur navigieren.In order to connect such a template reference to the page's logical tree, you should get the TemplatedParent value and continue to navigate that element tree as desired.

Gilt für: