Control::OnTemplateChanged Method (ControlTemplate^, ControlTemplate^)


Called whenever the control's template changes.

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

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