FrameworkElement.GetTemplateChild(String) Methode

Definition

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

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.DependencyObject

Protected Friend Function GetTemplateChild (childName As String) As DependencyObject

Parameter

childName

String

Name des gesuchten untergeordneten Elements.

Gibt zurück

DependencyObject

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.

Weitere Informationen

• FindName(String, FrameworkElement)