FrameworkElement.ApplyTemplate FrameworkElement.ApplyTemplate FrameworkElement.ApplyTemplate FrameworkElement.ApplyTemplate Method

Определение

При необходимости строит визуальное дерево текущего шаблона и возвращает значение, указывающее, было ли это визуальное дерево перестроено в результате этого вызова.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 -> bool
Public Function ApplyTemplate () As Boolean

Возвраты

Значение true, если в дерево были добавлены визуальные элементы; в противном случае — значение false.true if visuals were added to the tree; returns false otherwise.

Комментарии

Приложения могут вызывать этот метод, чтобы гарантировать, что визуальное дерево элемента завершено.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. Для типичной логики элемента в приложениях ApplyTemplate вызов не требуется, поскольку шаблоны будут применяться автоматически к элементам в соответствующей точке их жизненного цикла.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вызывается для каждой меры, передаваемых системой макета уровня платформы WPF.ApplyTemplate is called on every Measure pass by the WPF framework-level layout system.

FrameworkElementпроизводные классы могут использовать OnApplyTemplate обработчик класса для получения уведомлений о случаях, когда этот метод был вызван явным образом или системой макета.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вызывается после полного создания шаблона и присоединения к логическому дереву.OnApplyTemplate is called after the template is completely generated and attached to the logical tree.

Применяется к

Дополнительно