FrameworkElement.GetTemplateChild(String) FrameworkElement.GetTemplateChild(String) FrameworkElement.GetTemplateChild(String) FrameworkElement.GetTemplateChild(String) Method

Définition

Retourne l'élément nommé dans l'arborescence d'éléments visuels d'un ControlTemplate instancié.Returns the named element in the visual tree of an instantiated ControlTemplate.

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 String String String

Nom de l'enfant à rechercher.Name of the child to find.

Retours

Élément demandé.The requested element. Peut correspondre à une null si aucun élément du nom demandé n'existe.May be null if no element of the requested name exists.

Remarques

Les modèles WPFWPF dans possèdent une portée de certificat autonome.Templates in WPFWPF have a self-contained namescope. Cela est dû au fait que les modèles sont réutilisés et que n’importe quel nom défini dans un modèle ne peut pas rester unique lorsque plusieurs instances d’un contrôle instancient chacune son modèle.This is because templates are re-used, and any name defined in a template cannot remain unique when multiple instances of a control each instantiate its template. Appelez la GetTemplateChild méthode pour retourner des références aux objets qui proviennent du modèle après qu’il a été instancié.Call the GetTemplateChild method to return references to objects that come from the template after it is instantiated. Vous ne pouvez pas FrameworkElement.FindName utiliser la méthode pour rechercher des éléments FrameworkElement.FindName à partir de modèles, car agit dans une portée plus générale, et ControlTemplate il n’existe aucune connexion entre la classe elle-même et le modèle instancié une fois qu’elle est appliquée.You cannot use the FrameworkElement.FindName method to find items from templates because FrameworkElement.FindName acts in a more general scope, and there is no connection between the ControlTemplate class itself and the instantiated template once it is applied.

FrameworkTemplate.FindNamefournit la même fonction que cette méthode.FrameworkTemplate.FindName supplies the same function as this method. FrameworkTemplate.FindNameest public au lieu de protégé, et il utilise des considérations de portée de nom correctes qui lui permettent d’accéder au modèle dans un élément et de rechercher des éléments nommés dans celui-ci.FrameworkTemplate.FindName is public instead of protected, and it uses correct name-scoping considerations that allow it to access the template within an element and find named items within it. Utilisez FrameworkTemplate.FindName lorsque vous devez récupérer un élément en dehors de son contrôle parent.Use FrameworkTemplate.FindName when you need to get an element outside of its parent control.

S’applique à

Voir aussi