FrameworkElement.GetTemplateChild(String) Método

Definición

Devuelve el elemento con nombre del árbol visual de ControlTemplate con instancias.

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

Parámetros

childName
String

Nombre del elemento secundario que se busca.

Devoluciones

Elemento solicitado. Puede ser null si no existe ningún elemento con el nombre solicitado.

Comentarios

Las plantillas de WPF tienen un ámbito de nombres independiente. Esto se debe a que las plantillas se vuelven a usar y cualquier nombre definido en una plantilla no puede permanecer único cuando varias instancias de un control crean instancias de su plantilla. Llame al GetTemplateChild método para devolver referencias a objetos que proceden de la plantilla después de crear una instancia. No se puede usar el FrameworkElement.FindName método para buscar elementos de plantillas porque FrameworkElement.FindName actúa en un ámbito más general y no hay ninguna conexión entre la ControlTemplate propia clase y la plantilla con instancias una vez aplicada.

FrameworkTemplate.FindName proporciona la misma función que este método. FrameworkTemplate.FindName es público en lugar de protegido y usa consideraciones correctas para determinar el ámbito de nombres que le permiten acceder a la plantilla dentro de un elemento y buscar elementos con nombre dentro de él. Use FrameworkTemplate.FindName cuando necesite obtener un elemento fuera de su control primario.

Se aplica a

Consulte también