Control.OnTemplateChanged(ControlTemplate, ControlTemplate) Method

Definition

Namespace:
System.Windows.Controls
Assembly:
PresentationFramework.dll

Called whenever the control's template changes.

protected:
 virtual void OnTemplateChanged(System::Windows::Controls::ControlTemplate ^ oldTemplate, System::Windows::Controls::ControlTemplate ^ newTemplate);
protected virtual void OnTemplateChanged (System.Windows.Controls.ControlTemplate oldTemplate, System.Windows.Controls.ControlTemplate newTemplate);
abstract member OnTemplateChanged : System.Windows.Controls.ControlTemplate * System.Windows.Controls.ControlTemplate -> unit
override this.OnTemplateChanged : System.Windows.Controls.ControlTemplate * System.Windows.Controls.ControlTemplate -> unit
Protected Overridable Sub OnTemplateChanged (oldTemplate As ControlTemplate, newTemplate As ControlTemplate)

Parameters

oldTemplate
ControlTemplate

The old template.

newTemplate
ControlTemplate

The new template.

Remarks

The timing for changing the template is as follows:

  1. The template is changed by a SetValue method call, a style trigger, or some other means.

  2. The property value changes; the property-changed callback is called.

  3. The old visual tree is removed.

  4. An internal method is called which eventually calls the OnTemplateChanged method.

  5. Later, during a measure, OnApplyTemplate is called and a new visual tree is attached.

Applies to