FrameworkElement.OnApplyTemplate Metoda

Definicja

Gdy jest zastępowany w klasie pochodnej, jest wywoływana przy każdym wywołaniu kodu aplikacji lub procesów wewnętrznych ApplyTemplate() .When overridden in a derived class, is invoked whenever application code or internal processes call ApplyTemplate().

public:
 virtual void OnApplyTemplate();
public virtual void OnApplyTemplate ();
abstract member OnApplyTemplate : unit -> unit
override this.OnApplyTemplate : unit -> unit
Public Overridable Sub OnApplyTemplate ()

Uwagi

Ta metoda nie ma domyślnej implementacji.This method has no default implementation.

Szablony to sekcja ukończonego drzewa wizualnego elementu, która pochodzi z właściwości szablonu obiektu Style , który jest stosowany dla elementu.Templates are the section of an element's completed visual tree that comes from the Template property of a Style that is applied for the element. Aby uzyskać więcej informacji, zobacz Style i tworzenia szablonów.For more information, see Styling and Templating.

Uwagi dotyczące dziedziczenia

Klasy pochodne FrameworkElement mogą używać tej metody jako powiadomienia dla różnych możliwych scenariuszy:Derived classes of FrameworkElement can use this method as a notification for a variety of possible scenarios: — Możesz wywołać własną implementację kodu, która kompiluje resztę drzewa wizualnego elementu.- You can call your own implementation of code that builds the remainder of an element visual tree.

— Można uruchomić kod, który opiera się na drzewie wizualnym z szablonów, które zostały zastosowane, takich jak uzyskiwanie odwołań do nazwanych elementów, które pochodzą z szablonu.- You can run code that relies on the visual tree from templates having been applied, such as obtaining references to named elements that came from a template.

— Możesz wprowadzić usługi, które mają sens tylko wtedy, gdy drzewo wizualne z szablonów zostanie zakończone.- You can introduce services that only make sense to exist after the visual tree from templates is complete.

— Można ustawiać Stany i właściwości elementów w ramach szablonu, które są zależne od innych czynników.- You can set states and properties of elements within the template that are dependent on other factors. Na przykład wartości właściwości mogą być wykrywalne tylko przez znajomość elementu nadrzędnego lub w przypadku, gdy określona Klasa pochodna używa wspólnego szablonu.For instance, property values might only be discoverable by knowing the parent element, or when a specific derived class uses a common template.

Implementacje powinny zawsze wywoływać implementację podstawową przed ich wdrożeniem.Implementers should always call the base implementation before their own implementation. FrameworkElement sama nie ma żadnej domyślnej implementacji, ale mogą wystąpić klasy.FrameworkElement itself has no default implementation, but intervening classes might.

Control oferuje podobne przesłonięcie OnTemplateChanged(ControlTemplate, ControlTemplate) .Control offers a similar override, OnTemplateChanged(ControlTemplate, ControlTemplate).

Dotyczy