FrameworkElement.GetTemplateChild(String) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.DependencyObjectProtected Friend Function GetTemplateChild (childName As String) As DependencyObjectParâmetros
- childName
- String
Nome do filho a ser localizado.
Retornos
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.