FrameworkElement.GetTemplateChild(String) Método

Definição

Devolve o elemento nomeado na árvore visual de um .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

Nome da criança a encontrar.

Devoluções

O elemento pedido. Pode ser null , se não existir nenhum elemento do nome solicitado.

Observações

Os modelos no WPF têm um namescope autónomo. Isto deve-se ao facto de os templates serem reutilizados, e qualquer nome definido num template não pode permanecer único quando múltiplas instâncias de um controlo instanciam cada uma o seu template. Chame o GetTemplateChild método para devolver referências a objetos que vêm do template depois de este ser instanciado. Não podes usar o FrameworkElement.FindName método para encontrar itens a partir de templates porque FrameworkElement.FindName atua num âmbito mais geral, e não há ligação entre a ControlTemplate própria classe e o template instanciado uma vez aplicada.

FrameworkTemplate.FindName fornece a mesma função que este método. FrameworkTemplate.FindName é pública em vez de protegida, e utiliza considerações corretas de âmbito de nomes que lhe permitem aceder ao template dentro de um elemento e encontrar itens nomeados dentro dele. Usa FrameworkTemplate.FindName quando precisares de tirar um elemento fora do seu controlo pai.

Aplica-se a

Ver também