FrameworkElement.ApplyTemplate Method

Definition

Compila el árbol visual de la plantilla actual si es necesario y devuelve un valor que indica si esta llamada volvió a compilar el árbol visual.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

Returns

Boolean

true si se han agregado elementos visuales al árbol; devuelve false en caso contrario.true if visuals were added to the tree; returns false otherwise.

Remarks

Las aplicaciones pueden llamar a este método para garantizar que el árbol visual de un elemento está completo.Applications can call this method to guarantee that the visual tree of an element is complete. Este paso de garantía puede ser necesario si el código va a comprobar los elementos secundarios en el árbol.This guarantee step might be necessary if code will be checking the child elements in the tree. En el caso de la lógica de elementos típica dentro de las aplicaciones, no es necesario llamar a ApplyTemplate, ya que las plantillas se aplicarán a los elementos en un momento adecuado en sus duraciones automáticamente.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.

el sistema de diseño de nivel de marco de WPF llama a ApplyTemplate en cada paso de medida.ApplyTemplate is called on every Measure pass by the WPF framework-level layout system.

FrameworkElement clases derivadas pueden usar el controlador de la clase OnApplyTemplate para recibir notificaciones de los casos en los que se llamó a este método explícitamente o por el sistema de diseño.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. se llama a OnApplyTemplate después de que la plantilla se haya generado completamente y se haya adjuntado al árbol lógico.OnApplyTemplate is called after the template is completely generated and attached to the logical tree.

Applies to

See also