FrameworkElement.OnApplyTemplate Método
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 -> unit
Public Overridable Sub OnApplyTemplate ()
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.
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).
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 |