FrameworkElement.GetTemplateChild(String) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt das benannte Element in der visuellen Struktur der instanziierten ControlTemplate ab.
protected public:
System::Windows::DependencyObject ^ GetTemplateChild(System::String ^ childName);protected internal System.Windows.DependencyObject GetTemplateChild (string childName);member this.GetTemplateChild : string -> System.Windows.DependencyObjectProtected Friend Function GetTemplateChild (childName As String) As DependencyObjectParameter
- childName
- String
Name des gesuchten untergeordneten Elements.
Gibt zurück
Das angeforderte Element. Es kann null sein, wenn kein Element mit dem angeforderten Namen vorhanden ist.
Hinweise
Vorlagen in WPF verfügen über einen eigenständigen Namen. Dies liegt daran, dass Vorlagen erneut verwendet werden und jeder in einer Vorlage definierte Name nicht eindeutig bleiben kann, wenn mehrere Instanzen eines Steuerelements die Vorlage instanziieren. Rufen Sie die GetTemplateChild -Methode auf, um Verweise auf Objekte zurückzugeben, die aus der Vorlage stammen, nachdem sie instanziiert wurde. Sie können die FrameworkElement.FindName -Methode nicht verwenden, um Elemente aus Vorlagen zu finden, da FrameworkElement.FindName sie in einem allgemeineren Bereich ausgeführt wird und keine Verbindung zwischen der ControlTemplate Klasse selbst und der instanziierten Vorlage besteht, sobald sie angewendet wird.
FrameworkTemplate.FindName stellt dieselbe Funktion wie diese Methode bereit. FrameworkTemplate.FindName ist öffentlich statt geschützt, und es werden korrekte Überlegungen zum Namensrahmen verwendet, die es ihm ermöglichen, auf die Vorlage in einem Element zuzugreifen und benannte Elemente darin zu finden. Verwenden Sie FrameworkTemplate.FindName , wenn Sie ein Element außerhalb des übergeordneten Steuerelements abrufen müssen.
