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 aufzurufen, um sicherzustellen, dass die visuelle Struktur eines Elements fertiggestellt ist.Applications can call this method to guarantee that the visual tree of an element is complete. Dieser Garantie Schritt ist möglicherweise erforderlich, wenn der Code die untergeordneten Elemente in der Struktur prüft.This guarantee step might be necessary if code will be checking the child elements in the tree. Für eine typische Element Logik innerhalb von Anwendungen ApplyTemplate ist das Aufrufen von nicht erforderlich, da Vorlagen auf Elemente an einem geeigneten Punkt 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.

ApplyTemplatewird für jedes Measure aufgerufen, das vom Layout-System auf WPF-Frameworkebene übergeben wird.ApplyTemplate is called on every Measure pass by the WPF framework-level layout system.

FrameworkElementabgeleitete Klassen können den OnApplyTemplate Klassen Handler verwenden, um über Fälle benachrichtigt zu werden, in denen diese Methode explizit oder vom Layoutsystem aufgerufen wurde.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. OnApplyTemplatewird aufgerufen, nachdem die Vorlage vollständig generiert und an die logische Struktur angefügt wurde.OnApplyTemplate is called after the template is completely generated and attached to the logical tree.

Gilt für:

Siehe auch