Compartilhar via


FrameworkElement.GetTemplateChild(String) Método

Definição

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

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 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