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

Definition

Wird aufgerufen, wenn das übergeordnete Element dieses Elements in der visuellen Struktur geändert wird.Invoked when the parent of this element in the visual tree is changed. Überschreibt 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)

Parameter

oldParent
DependencyObject DependencyObject DependencyObject DependencyObject

Das alte übergeordnete Element.The old parent element. Kann null sein, um anzugeben, dass das Element zuvor über kein visuelles übergeordnetes Element verfügt hat.May be null to indicate that the element did not have a visual parent previously.

Hinweise

Die visuelle Struktur unterscheidet sich möglicherweise von der logischen Struktur da Elemente weggelassen wird, die nicht visuell, z. B. Sammlungen, rendern und einige Elemente auf der Grundlage ihrer Zusammensetzung-Design- und erweitert.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. Weitere Informationen finden Sie unter Strukturen in WPF.For more information, see Trees in WPF.

Hinweise für Vererber

Die Standardimplementierung dieser virtuellen Methode fragt das neue übergeordnete Element löst Initialisierungsereignisse aus verschiedenen und internen Flags zum Status der Initialisierung des legt die FrameworkElement je nach Bedarf.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. Schließlich ruft es gemäß der Deklaration durch aufeinander folgende basisimplementierungen UIElement, wiederum ruft die Basis in Visual.Finally, it calls the successive base implementations as declared by UIElement, which in turn calls its base in Visual. Rufen Sie immer die basisimplementierung bereit, dieses Verhalten beizubehalten, andernfalls das Verhalten für die Struktur von Elementen für dieses Element wird als ein untergeordnetes Element eines anderen Elements deklariert möglicherweise nicht wie erwartet.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.

Einige vorhandene Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) Klassen überschreiben diese Methode, z. B.: 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). Das häufigste Szenario ist, um zu erzwingen, dass das neue übergeordnete Element eines bestimmten Typs sein muss.The most common scenario is to enforce that the new parent must be a particular type. Dabei wird z. B. eine Ausnahme auszulösen, wenn das neue übergeordnete Element einige Typtest fehlgeschlagen ist.This might involve throwing an exception if the new parent failed some manner of type test. Eine spezielle Version dieses Szenarios, die in den Implementierungen für Listenelemente und Menüelemente, die keine außerhalb einer übergeordneten visuellen sinnvoll sind, die zum Speichern in eine entsprechende Sammlung besitzt vorhanden ist.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. Beachten Sie, dass es sich bei diesen Fällen nicht unbedingt Ausnahmen ausgelöst, da möglicherweise gibt es Szenarien, die für die neuzuordnung des übergeordneten Elements der Elemente, die vorübergehend ohne "regular" ihren übergeordneten Elementen basieren.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.

Diese Methode wird auch in bestimmte Elemente, die in der Regel das Stammelement, wie z. B. überschrieben Window.This method is also overridden in certain elements that are typically the root element, such as Window. Ein weiterer Fall ist, Elemente, die das Stammelement in Markup, aber der automatischen Generierung eine größere Infrastruktur in einer kompilierten logischen Struktur (z. B. 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). Die Window und Page Implementierungen absichtlich versiegeln Sie die Methode.The Window and Page implementations deliberately seal the method.

Gilt für:

Siehe auch