Partager via


FrameworkElement.GetTemplateChild(String) Méthode

Définition

Retourne l'élément nommé dans l'arborescence d'éléments visuels d'un ControlTemplate instancié.

protected public:
 System::Windows::DependencyObject ^ GetTemplateChild(System::String ^ childName);
protected internal System.Windows.DependencyObject GetTemplateChild (string childName);
member this.GetTemplateChild : string -> System.Windows.DependencyObject
Protected Friend Function GetTemplateChild (childName As String) As DependencyObject

Paramètres

childName
String

Nom de l'enfant à rechercher.

Retours

DependencyObject

Élément demandé. Peut correspondre à une null si aucun élément du nom demandé n'existe.

Remarques

Les modèles dans WPF ont un namescope autonome. Cela est dû au fait que les modèles sont réutilisés et que tout nom défini dans un modèle ne peut pas rester unique lorsque plusieurs instances d’un contrôle instancient chaque modèle. Appelez la GetTemplateChild méthode pour renvoyer des références aux objets provenant du modèle après son instanciation. Vous ne pouvez pas utiliser la FrameworkElement.FindName méthode pour rechercher des éléments à partir de modèles, car FrameworkElement.FindName il agit dans une étendue plus générale, et il n’existe aucune connexion entre la ControlTemplate classe elle-même et le modèle instancié une fois qu’il est appliqué.

FrameworkTemplate.FindName fournit la même fonction que cette méthode. FrameworkTemplate.FindName est public au lieu d’être protégé et utilise des considérations correctes relatives à l’étendue du nom qui lui permettent d’accéder au modèle dans un élément et de trouver des éléments nommés dans celui-ci. Utilisez FrameworkTemplate.FindName quand vous devez obtenir un élément en dehors de son contrôle parent.

S’applique à

Voir aussi