FrameworkElement.ApplyTemplate 方法

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

在必要时生成当前模板的可视化树，然后返回一个值，该值指示可视化树是否由此调用重新生成。

public:
 bool ApplyTemplate();

public bool ApplyTemplate ();

member this.ApplyTemplate : unit -> bool

Public Function ApplyTemplate () As Boolean

如果在树中添加了视觉对象，则返回 true；否则返回 false。

应用程序可以调用此方法，以确保元素的可视化树已完成。如果代码将检查树中的子元素，则可能需要执行此保证步骤。对于应用程序中的典型元素逻辑，不需要调用 ApplyTemplate ，因为模板将自动应用于其生存期内适当点的元素。

ApplyTemplate 在 WPF 框架级布局系统的每个 Measure 传递上调用。

FrameworkElement 派生类可以使用 OnApplyTemplate 类处理程序来通知显式调用此方法或布局系统的情况。 OnApplyTemplate 在完全生成模板并将其附加到逻辑树后调用。