FrameworkElement.OnApplyTemplate 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.
Quando sobreposto numa classe derivada, é invocado sempre que o código da aplicação ou processos internos chamam ApplyTemplate().
public:
virtual void OnApplyTemplate();public virtual void OnApplyTemplate();abstract member OnApplyTemplate : unit -> unit
override this.OnApplyTemplate : unit -> unitPublic Overridable Sub OnApplyTemplate ()Observações
Este método não tem implementação por defeito.
Os templates são a secção da árvore visual concluída de um elemento que provém da propriedade Template de a Style que é aplicada ao elemento. Para obter mais informações, consulte Styling and Templating.
Notas para Herdeiros
Classes derivadas de FrameworkElement podem usar este método como notificação para uma variedade de cenários possíveis:
Podes chamar a tua própria implementação de código que constrói o restante de um elemento de árvore visual.
Podes executar código que depende da árvore visual a partir de templates já aplicados, como obter referências a elementos nomeados que vieram de um template.
Podes introduzir serviços que só fazem sentido para existirem depois de a árvore visual dos templates estar concluída.
Podes definir estados e propriedades de elementos dentro do template que dependem de outros fatores. Por exemplo, os valores das propriedades podem ser descobertos apenas conhecendo o elemento pai, ou quando uma classe derivada específica usa um modelo comum.
Os implementadores devem sempre chamar a implementação base antes da sua própria implementação. FrameworkElement ele próprio não tem uma implementação padrão, mas as classes intermediárias podem ter.
Control oferece uma sobreposição semelhante, OnTemplateChanged(ControlTemplate, ControlTemplate).