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

Modèles dans WPFWPF ont une portée de nom autonome.Templates in WPFWPF have a self-contained namescope. Il s’agit, car les modèles sont réutilisés et n’importe quel nom défini dans un modèle ne peut pas rester unique lorsque plusieurs instances d’un contrôle instancient 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 le GetTemplateChild méthode pour retourner des références aux objets qui proviennent du modèle après son instanciation.Call the GetTemplateChild method to return references to objects that come from the template after it is instantiated. Vous ne pouvez pas utiliser le FrameworkElement.FindName méthode pour rechercher des éléments à partir de modèles, car FrameworkElement.FindName agit en général plus étendue, et il n’existe aucune connexion entre la ControlTemplate classe lui-même et le modèle instancié une fois qu’il est appliqué.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.FindName Fournit la même fonction que cette méthode.FrameworkTemplate.FindName supplies the same function as this method. FrameworkTemplate.FindName protégé public au lieu de, et utilise des considérations correctes de portée de nom qui lui permettent d’accéder au modèle au sein d’un élément et la recherche d’éléments nommés.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 avez besoin obtenir 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