FrameworkElement.OnApplyTemplate 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.
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 -> unitPublic 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).