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 在完全生成模板并将其附加到逻辑树后调用。