OnTemplateChanged Method

Control.OnTemplateChanged Method (ControlTemplate, ControlTemplate)


Called whenever the control's template changes.

Namespace:   System.Windows.Controls
Assembly:  PresentationFramework (in PresentationFramework.dll)

protected virtual void OnTemplateChanged(
	ControlTemplate oldTemplate,
	ControlTemplate newTemplate


Type: System.Windows.Controls.ControlTemplate

The old template.

Type: System.Windows.Controls.ControlTemplate

The new template.

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.

.NET Framework
Available since 3.0
Return to top
© 2015 Microsoft