Freigeben über


FrameworkElement.ApplyTemplate Methode

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.

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.

Hinweise

Anwendungen können diese Methode aufrufen, um sicherzustellen, dass die visuelle Struktur eines Elements vollständig ist. Dieser Garantieschritt kann erforderlich sein, wenn code die untergeordneten Elemente in der Struktur überprüft. Für typische Elementlogik in Anwendungen ist der Aufruf ApplyTemplate nicht erforderlich, da Vorlagen automatisch zu einem geeigneten Zeitpunkt ihrer Lebensdauer auf Elemente angewendet werden.

ApplyTemplate wird bei jedem Measuredurchlauf vom WPF-Layoutsystem auf Frameworkebene aufgerufen.

FrameworkElement Abgeleitete Klassen können den OnApplyTemplate Klassenhandler verwenden, um über Fälle benachrichtigt zu werden, in denen diese Methode explizit oder vom Layoutsystem aufgerufen wurde. OnApplyTemplate wird aufgerufen, nachdem die Vorlage vollständig generiert und an die logische Struktur angefügt wurde.

Gilt für:

Weitere Informationen