FrameworkElement.GetTemplateChild(String) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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.