FrameworkElement.OnApplyTemplate Método

Definição

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

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

public:
 virtual void OnApplyTemplate();

public virtual void OnApplyTemplate ();

abstract member OnApplyTemplate : unit -> unit
override this.OnApplyTemplate : unit -> unit

Public Overridable Sub 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).