FrameworkElement.GetTemplateChild(String) Método

Definición

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.

Se aplica a

Consulte también