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

Definition

Gibt das benannte Element in der visuellen Struktur der instanziierten ControlTemplate ab.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

Parameter

childName
String String String String

Name des gesuchten untergeordneten Elements.Name of the child to find.

Gibt zurück

Das angeforderte Element.The requested element. Es kann null sein, wenn kein Element mit dem angeforderten Namen vorhanden ist.May be null if no element of the requested name exists.

Hinweise

Vorlagen in WPFWPF verfügen über einen eigenständigen Namescope.Templates in WPFWPF have a self-contained namescope. Dies liegt daran, dass Vorlagen erneut verwendet werden, und jeder in einer Vorlage definierte Name kann nicht eindeutig bleiben, wenn mehrere Instanzen eines Steuer Elements jeweils seine Vorlage instanziieren.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. Ruft die GetTemplateChild -Methode auf, um Verweise auf Objekte zurückzugeben, die aus der Vorlage stammen, nachdem Sie instanziiert wurde.Call the GetTemplateChild method to return references to objects that come from the template after it is instantiated. Sie können die FrameworkElement.FindName -Methode nicht verwenden, um Elemente aus FrameworkElement.FindName Vorlagen zu finden, da in einem allgemeineren Bereich agiert und keine Verbindung zwischen ControlTemplate der Klasse selbst und der instanziierten Vorlage besteht, nachdem Sie angewendet wurde.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.FindNamestellt dieselbe Funktion bereit wie diese Methode.FrameworkTemplate.FindName supplies the same function as this method. FrameworkTemplate.FindNameist nicht geschützt, sondern verwendet korrekte namens Bereichs Überlegungen, die den Zugriff auf die Vorlage innerhalb eines Elements und das Auffinden benannter Elemente innerhalb des Elements ermöglichen.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. Verwenden FrameworkTemplate.FindName Sie, wenn Sie ein Element außerhalb des übergeordneten Steuer Elements erhalten müssen.Use FrameworkTemplate.FindName when you need to get an element outside of its parent control.

Gilt für:

Siehe auch