FrameworkElement.ApplyTemplate Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Builds the current template's visual tree if necessary, and returns a value that indicates whether the visual tree was rebuilt by this call.
public:
bool ApplyTemplate();public bool ApplyTemplate ();member this.ApplyTemplate : unit -> boolPublic Function ApplyTemplate () As BooleanReturns
true if visuals were added to the tree; returns false otherwise.
Remarks
Applications can call this method to guarantee that the visual tree of an element is complete. This guarantee step might be necessary if code will be checking the child elements in the tree. For typical element logic within applications, calling ApplyTemplate is not necessary, because templates will be applied to elements at an appropriate point in their lifetimes automatically.
ApplyTemplate is called on every Measure pass by the WPF framework-level layout system.
FrameworkElement derived classes can use the OnApplyTemplate class handler to be notified of cases where this method was called explicitly, or by the layout system. OnApplyTemplate is called after the template is completely generated and attached to the logical tree.
