FrameworkElement.OnVisualParentChanged(DependencyObject) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Wird aufgerufen, wenn das übergeordnete Element dieses Elements in der visuellen Struktur geändert wird. Überschreibt 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
Das alte übergeordnete Element. Es kann null sein, dass das Element zuvor kein visuelles übergeordnetes Element aufweist.
Hinweise
Die visuelle Struktur unterscheidet sich möglicherweise von der logischen Struktur, da elemente weggelassen werden, die nicht visuell gerendert werden, z. B. Sammlungen, und erweitert einige Elemente auf der Grundlage ihres Designs und der Stilkomositing. Weitere Informationen finden Sie unter "Trees" in WPF.
Hinweise für Vererber
Die Standardimplementierung dieser virtuellen Methode fragt nach dem neuen übergeordneten Element ab, löst verschiedene Initialisierungsereignisse aus und legt interne Flags zum Initialisierungsstatus des FrameworkElement entsprechenden Objekts fest. Schließlich ruft sie die aufeinander folgenden Basisimplementierungen wie deklariert UIElementauf, wodurch wiederum die Basis aufgerufen Visualwird. Rufen Sie immer die Basisimplementierung auf, um dieses Verhalten beizubehalten, andernfalls ist das Verhalten der Elementstruktur für dieses Element, wenn sie als untergeordnetes Element eines anderen Elements deklariert wird, möglicherweise nicht wie erwartet.
Einige vorhandene Windows Presentation Foundation -Klassen (WPF) überschreiben diese Methode, z. B. OnVisualParentChanged(DependencyObject), OnVisualParentChanged(DependencyObject). Das häufigste Szenario besteht darin, zu erzwingen, dass das neue übergeordnete Element ein bestimmter Typ sein muss. Dies kann das Auslösen einer Ausnahme umfassen, wenn das neue übergeordnete Element eine Art von Typtest fehlgeschlagen ist. Eine spezielle Version dieses Szenarios ist in Implementierungen für Listenelemente und Menüelemente vorhanden, die außerhalb eines übergeordneten visuellen Elements keinen Sinn machen, der eine entsprechende Sammlung zum Speichern besitzt. Beachten Sie, dass diese Fälle keine Ausnahmen auslösen, da es möglicherweise Designerszenarien gibt, die sich auf die Analyse von Elementen verlassen, die momentan ohne ihre "regulären" Eltern sind.
Diese Methode wird auch in bestimmten Elementen überschrieben, die in der Regel das Stammelement sind, z Window. B. . Ein weiterer Fall sind Elemente, die das scheinbare Stammelement im Markup sind, aber eine größere Infrastruktur in einer kompilierten logischen Struktur automatisch generiert (z Page. B. ). Die Window Und Page Implementierungen versiegeln die Methode bewusst.