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 potenziell von der logischen Struktur, da Sie keine Elemente auslässt, die nicht visuell dargestellt werden, z. b. Auflistungen, und einige Elemente auf Grundlage ihrer Design-und Stil Komposition 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 Standard Implementierung dieser virtuellen Methode fragt das neue übergeordnete Element ab, löst verschiedene Initialisierungs Ereignisse aus und legt interne Flags über den FrameworkElement Initialisierungs Zustand von entsprechend fest.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 Sie die aufeinander folgenden Basis Implementierungen gemäß der Deklaration von UIElementauf, die wiederum ihre Basis in Visualaufruft.Finally, it calls the successive base implementations as declared by UIElement, which in turn calls its base in Visual. Die Basis Implementierung wird immer aufgerufen, um dieses Verhalten beizubehalten, andernfalls ist das Elementstruktur Verhalten für dieses Element, wenn es als untergeordnetes Element eines anderen Elements deklariert ist, 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 OnVisualParentChanged(DependencyObject). b 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 besteht darin, dass das neue übergeordnete Element einen bestimmten Typ aufweisen muss.The most common scenario is to enforce that the new parent must be a particular type. Dies kann dazu führen, dass eine Ausnahme ausgelöst wird, wenn das neue übergeordnete Element einen Typtest nicht bestanden hat.This might involve throwing an exception if the new parent failed some manner of type test. Eine spezielle Version dieses Szenarios ist in Implementierungen für Listenelemente und Menü Elemente enthalten, die außerhalb eines übergeordneten visuellen Elements, das eine entsprechende Auflistung besitzt, nicht in den Speicher zu speichern.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 diese Fälle nicht notwendigerweise Ausnahmen hervorrufen, da es möglicherweise Designer Szenarien gibt, die sich auf die Neuzuordnung von Elementen stützen, die sich vorübergehend ohne Ihre "regulären" übergeordneten Elemente befinden.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 bestimmten Elementen überschrieben, die in der Regel das Stamm Element sind Window, z. b.This method is also overridden in certain elements that are typically the root element, such as Window. Ein weiterer Fall sind Elemente, die das sichtbare Stamm Element im Markup sind, jedoch eine größere Infrastruktur in einer kompilierten logischen Struktur (z Page. b.) automatisch generieren.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 - Page und-Implementierungen versiegeln die-Methode absichtlich.The Window and Page implementations deliberately seal the method.

Gilt für:

Siehe auch