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 en el árbol visual de una instancia de 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
Parámetros
- childName
- String
Nombre del elemento secundario que se va a buscar.
Devoluciones
Elemento solicitado. Puede ser null si no existe ningún elemento del 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 instancias. 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 creada una vez que se aplica.
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.