FrameworkElement.OnApplyTemplate Méthode

Définition

Espace de noms:

System.Windows

Assembly:

PresentationFramework.dll

En cas de substitution dans une classe dérivée, appelé chaque fois que le code de l’application ou que des processus internes appellent ApplyTemplate().

public:
 virtual void OnApplyTemplate();

public virtual void OnApplyTemplate ();

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

Public Overridable Sub OnApplyTemplate ()

Remarques

Cette méthode n’a pas d’implémentation par défaut.

Les modèles sont la section de l’arborescence visuelle terminée d’un élément qui provient de la propriété Template d’un Style élément appliqué à l’élément. Pour plus d’informations, consultez Application d’un style et création de modèles.

Notes pour les héritiers

Les classes dérivées de FrameworkElement peuvent utiliser cette méthode comme notification pour divers scénarios possibles :

• Vous pouvez appeler votre propre implémentation de code qui génère le reste d’une arborescence visuelle d’élément.

• Vous pouvez exécuter du code qui s’appuie sur l’arborescence visuelle à partir de modèles ayant été appliqués, comme l’obtention de références à des éléments nommés provenant d’un modèle.

• Vous pouvez introduire des services qui n’ont aucun sens à exister une fois l’arborescence visuelle effectuée à partir de modèles.

• Vous pouvez définir des états et des propriétés d’éléments au sein du modèle qui dépendent d’autres facteurs. Par exemple, les valeurs de propriété peuvent être détectables uniquement en connaissant l’élément parent, ou lorsqu’une classe dérivée spécifique utilise un modèle commun.

Les implémenteurs doivent toujours appeler l’implémentation de base avant leur propre implémentation. FrameworkElement elle-même n’a pas d’implémentation par défaut, mais les classes intermédiaires peuvent.

Control offre un remplacement similaire, OnTemplateChanged(ControlTemplate, ControlTemplate).