FrameworkElement.TemplatedParent Propriété

Définition

Obtient une référence au modèle parent de cet élément.Gets a reference to the template parent of this element. Cette propriété n’est pas pertinente si l’élément n’a pas été créé par l’intermédiaire d’un modèle.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

Valeur de propriété

DependencyObject

Élément dont le FrameworkTemplateVisualTree a provoqué la création de cet élément.The element whose FrameworkTemplateVisualTree caused this element to be created. Cette valeur est souvent nullstatique vide.This value is frequently null.

Remarques

TemplatedParent est fréquemment null utilisé pour les objets qui sont créés dans le balisage ou le code de votre application.TemplatedParent is frequently null for objects that are created in your application markup or code. Cela est dû au fait que vous créez directement ces objets, et non par le biais d’un modèle.This is because you create those objects directly, not via a template. Les références d’objets obtenues en parcourant l’arborescence logique à partir de la racine, ou par des références de nom typiques, ne proviennent pas d’un modèle.Object references obtained by walking the logical tree from the root, or by typical name references, do not come from a template.

Les cas où TemplatedParent peuvent ne pas null inclure des opérations telles que le test d’atteinte, la gestion des événements pour certains événements d’entrée de bas niveau, le parcours de l’arborescence visuelle avec ou l' VisualTreeHelper utilisation d’énumérateurs, qui peuvent retourner des éléments provenant de modèles.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. Autre cas de figure : Si vous appelez spécifiquement FindName sur un existant et que vous travaillez FrameworkTemplate avec l’objet retourné.Another case is if you specifically call FindName against an existing FrameworkTemplate and are work with the returned object.

Les modèles sont en fait des objets partagés, où le contenu du modèle n’est créé qu’une seule fois.Templates are actually shared objects, where the contents of the template are created only once. Par conséquent, si vous obtenez une référence d’objet à un élément provenant d’un modèle, vous pouvez constater que l’arborescence logique apparente n’atteint pas la racine de la page.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. Pour connecter une telle référence de modèle à l’arborescence logique de la page, vous devez obtenir la TemplatedParent valeur et continuer à naviguer dans cette arborescence d’éléments comme vous le souhaitez.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.

S’applique à