FrameworkElement.GetTemplateChild(String) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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.