FrameworkElement.GetTemplateChild(String) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
É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.