FrameworkElement.OnApplyTemplate Método

Definição

Quando substituído em uma classe derivada, é chamado sempre que o código do aplicativo ou os processos internos chamarem ApplyTemplate().

C#
public virtual void OnApplyTemplate ();

Comentários

Esse método não tem implementação padrão.

Os modelos são a seção da árvore visual concluída de um elemento que vem da propriedade Template de um Style que é aplicado ao elemento. Para obter mais informações, consulte Estilo e Modelagem.

Notas aos Herdeiros

As classes derivadas podem FrameworkElement usar esse método como uma notificação para uma variedade de cenários possíveis:

  • Você pode chamar sua própria implementação de código que compila o restante de uma árvore visual de elemento.

– Você pode executar um código que depende da árvore visual de modelos que foram aplicados, como a obtenção de referências a elementos nomeados provenientes de um modelo.

– Você pode introduzir serviços que só fazem sentido existir após a conclusão da árvore visual dos modelos.

  • Você pode definir estados e propriedades de elementos dentro do modelo que dependem de outros fatores. Por exemplo, os valores de propriedade só podem ser detectáveis 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 de sua própria implementação. FrameworkElement em si não tem nenhuma implementação padrão, mas as classes intervindo podem.

Control oferece uma substituição semelhante, OnTemplateChanged(ControlTemplate, ControlTemplate).

Aplica-se a

Produto Versões
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
Windows Desktop 3.0, 3.1, 5, 6, 7