TemplatedParent Property

FrameworkElement.TemplatedParent Property


Gets a reference to the template parent of this element. This property is not relevant if the element was not created through a template.

Namespace:   System.Windows
Assembly:  PresentationFramework (in PresentationFramework.dll)

public DependencyObject TemplatedParent { get; }

Property Value

Type: System.Windows.DependencyObject

The element whose FrameworkTemplate VisualTree caused this element to be created. This value is frequently null; see Remarks.

TemplatedParent is frequently null for objects that are created in your application markup or code. This is because you create those objects directly, not via a template. Object references obtained by walking the logical tree from the root, or by typical name references, do not come from a template.

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. Another case is if you specifically call FindName against an existing FrameworkTemplate and are work with the returned object.

Templates are actually shared objects, where the contents of the template are created only once. Therefore, if you obtain an object reference to an element that came from a template, you may find that the apparent does not reach to the page root. 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.GTMT

.NET Framework
Available since 3.0
Return to top
© 2015 Microsoft