FrameworkElement.GetTemplateChild(String) Método

Definição

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Retorna o elemento nomeado na árvore visual de um ControlTemplate instanciado.

C#

protected internal System.Windows.DependencyObject GetTemplateChild (string childName);

Parâmetros

childName

String

Nome do filho a ser localizado.

Retornos

DependencyObject

O elemento solicitado. Poderá ser null se nenhum elemento com o nome solicitado existir.

Comentários

Os modelos no WPF têm um namescope autocontido. Isso ocorre porque os modelos são reutilizantes e qualquer nome definido em um modelo não pode permanecer exclusivo quando várias instâncias de um controle instanciam seu modelo. Chame o GetTemplateChild método para retornar referências a objetos provenientes do modelo depois que ele for instanciado. Você não pode usar o FrameworkElement.FindName método para localizar itens de modelos porque FrameworkElement.FindName atua em um escopo mais geral e não há nenhuma conexão entre a ControlTemplate própria classe e o modelo instanciado depois que ele é aplicado.

FrameworkTemplate.FindName fornece a mesma função que este método. FrameworkTemplate.FindName é público em vez de protegido e usa considerações corretas de escopo de nome que permitem que ele acesse o modelo dentro de um elemento e localize itens nomeados dentro dele. Use FrameworkTemplate.FindName quando precisar obter um elemento fora do controle pai.

Aplica-se a

Confira também

• FindName(String, FrameworkElement)