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

Definition

Erstellt bei Bedarf die visuelle Struktur der aktuellen Vorlage und gibt einen Wert zurück, der angibt, ob die visuelle Struktur durch diesen Aufruf neu erstellt wurde.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

Gibt zurück

true, wenn der Struktur visuelle Elemente hinzugefügt wurden, andernfalls wird false zurückgegeben.true if visuals were added to the tree; returns false otherwise.

Hinweise

Anwendungen können diese Methode, um sicherzustellen, dass die visuelle Struktur eines Elements abgeschlossen ist, aufrufen.Applications can call this method to guarantee that the visual tree of an element is complete. Dieser Schritt ist möglicherweise erforderlich, wenn der Code überprüft werden, die untergeordneten Elemente in der Struktur wird.This guarantee step might be necessary if code will be checking the child elements in the tree. Für typische Element Logik in Anwendungen, Aufrufen von ApplyTemplate ist nicht erforderlich, da die Vorlagen für Elemente an einer geeigneten Stelle in ihrer Lebensdauer automatisch angewendet werden.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 wird aufgerufen, für jedes Measure durch das Layoutsystem von WPF-Frameworkebene übergeben.ApplyTemplate is called on every Measure pass by the WPF framework-level layout system.

FrameworkElement abgeleitete Klassen können die OnApplyTemplate Klassenhandler der Fälle, in diese Methode explizit aufgerufen wurde, oder durch das Layoutsystem benachrichtigt werden.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 wird aufgerufen, nachdem die Vorlage vollständig generiert und an der logischen Struktur angefügt.OnApplyTemplate is called after the template is completely generated and attached to the logical tree.

Gilt für:

Siehe auch