Langage

FrameworkElement.OnApplyTemplate Méthode

Définition

Espace de noms:
System.Windows
Assembly:
PresentationFramework.dll

En cas de substitution dans une classe dérivée, est appelée chaque fois que le code de l’application ou les 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 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, par exemple obtenir des références à des éléments nommés provenant d’un modèle.

  • Vous pouvez introduire des services qui n’ont aucun sens après la fin de l’arborescence visuelle à partir de modèles.

  • Vous pouvez définir des états et des propriétés d’éléments dans le 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).

S’applique à