FrameworkElement.OnVisualParentChanged(DependencyObject) FrameworkElement.OnVisualParentChanged(DependencyObject) FrameworkElement.OnVisualParentChanged(DependencyObject) FrameworkElement.OnVisualParentChanged(DependencyObject) Method

Définition

Appelée en cas de modification du parent de cet élément dans l’arborescence visuelle.Invoked when the parent of this element in the visual tree is changed. Substitue OnVisualParentChanged(DependencyObject).Overrides OnVisualParentChanged(DependencyObject).

protected public:
 override void OnVisualParentChanged(System::Windows::DependencyObject ^ oldParent);
protected internal override void OnVisualParentChanged (System.Windows.DependencyObject oldParent);
override this.OnVisualParentChanged : System.Windows.DependencyObject -> unit
Protected Friend Overrides Sub OnVisualParentChanged (oldParent As DependencyObject)

Paramètres

oldParent
DependencyObject DependencyObject DependencyObject DependencyObject

Ancien élément parent.The old parent element. Peut être null pour indiquer que l’élément n’avait pas de parent visuel auparavant.May be null to indicate that the element did not have a visual parent previously.

Remarques

L’arborescence visuelle peut être différente de l’arborescence logique, car elle omet les éléments qui ne s’affichent pas visuellement, telles que des collections et développe des éléments en fonction de la composition de leur thème et de style.The visual tree is potentially different from the logical tree because it omits elements that do not render visually, such as collections, and expands some elements on the basis of their theme and style compositing. Pour plus d’informations, consultez Arborescences dans WPF.For more information, see Trees in WPF.

Notes pour les héritiers

L’implémentation par défaut de cette méthode virtuelle interroge pour le nouveau parent, déclenche différents événements d’initialisation et définit des indicateurs internes à propos de l’état d’initialisation de la FrameworkElement selon le cas.The default implementation of this virtual method queries for the new parent, raises various initialization events, and sets internal flags about initialization state of the FrameworkElement as appropriate. Enfin, il appelle les implémentations de base consécutives déclarée par UIElement, qui appelle à son tour sa base dans Visual.Finally, it calls the successive base implementations as declared by UIElement, which in turn calls its base in Visual. Toujours appeler l’implémentation de base pour maintenir ce comportement, sinon le comportement d’arborescence élément pour cet élément lorsque déclaré en tant qu’enfant d’un autre élément peut-être pas comme prévu.Always call the base implementation to preserve this behavior, otherwise the element tree behavior for this element when declared as a child of another element may not be as expected.

Quelques-unes des Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) classes substituer cette méthode, par exemple : OnVisualParentChanged(DependencyObject), OnVisualParentChanged(DependencyObject).A few existing Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) classes override this method, for example: OnVisualParentChanged(DependencyObject), OnVisualParentChanged(DependencyObject). Le scénario le plus courant consiste à appliquer que le nouveau parent doit être un type particulier.The most common scenario is to enforce that the new parent must be a particular type. Cela peut impliquer de lever une exception si le nouveau parent a échoué à un mode quelconque de test de type.This might involve throwing an exception if the new parent failed some manner of type test. Il existe une version spécialisée de ce scénario dans les implémentations pour les éléments de liste et les éléments de menu, qui ne sont pas justifiés tout en dehors d’un parent visuel qui possède une collection appropriée pour les stocker dans.A specialized version of this scenario exists in implementations for list items and menu items, which do not make any sense outside a parent visual that owns an appropriate collection to store them in. Notez que ces cas ne déclenchent pas nécessairement les exceptions, car il peut y avoir des scénarios de concepteur qui s’appuient sur la réattribution des éléments qui sont momentanément sans leurs parents « regular ».Note that these cases do not necessarily raise exceptions, because there might be designer scenarios that rely on reparenting elements that are momentarily without their "regular" parents.

Cette méthode est également substituée dans certains éléments qui sont en général l’élément racine, tel que Window.This method is also overridden in certain elements that are typically the root element, such as Window. Un autre cas serait les éléments qui sont l’élément racine apparent dans le balisage mais qui génèrent automatiquement une infrastructure supérieure dans une arborescence logique compilée (tel que Page).Another case is elements that are the apparent root element in markup but which autogenerate a greater infrastructure in a compiled logical tree (such as Page). Le Window et Page implémentations scellent délibérément la méthode.The Window and Page implementations deliberately seal the method.

S’applique à

Voir aussi