Para ver el artículo en inglés, active la casilla Inglés. También puede ver el texto en inglés en una ventana emergente si pasa el puntero del mouse por el texto.
Traducción
Inglés
Esta documentación está archivada y no tiene mantenimiento.

FrameworkElement.OnVisualParentChanged (Método)

Se invoca cuando cambia el elemento primario de este elemento en el árbol visual. Reemplaza a OnVisualParentChanged.

Espacio de nombres:  System.Windows
Ensamblado:  PresentationFramework (en PresentationFramework.dll)

protected internal override void OnVisualParentChanged(
	DependencyObject oldParent
)

Parámetros

oldParent
Tipo: System.Windows.DependencyObject
Elemento primario anterior. Puede ser null para indicar que el elemento no tenía previamente un elemento primario visual.

El árbol visual puede ser diferente del árbol lógico porque omite los elementos que no se pueden representar visualmente, como las colecciones, y expande algunos elementos según su composición de tema y estilo. Para obtener más información, vea Árboles en WPF.

Notas para los herederos

La implementación predeterminada de este método virtual consulta el nuevo elemento primario, provoca varios eventos de inicialización y establece según corresponda los marcadores internos sobre el estado de inicialización de FrameworkElement. Finalmente, llama a las implementaciones base sucesivas tal como declara UIElement, que a su vez llama a su base en Visual. Llame siempre a la implementación base para conservar este comportamiento; de lo contrario, el comportamiento del árbol de elementos puede no ser el que se esperaba para este elemento cuando se declara como secundario de otro elemento.

Unas cuantas clases existentes de Windows Presentation Foundation (WPF) invalidan este método, por ejemplo: Window.OnVisualParentChanged, ListBoxItem.OnVisualParentChanged. El escenario más común es exigir que el nuevo elemento primario sea de un tipo determinado. Esto podría implicar que se inicie una excepción si el nuevo elemento primario produce un error en alguna prueba de tipo. Una versión especializada de este escenario existe en implementaciones para los elementos de lista y elementos de menú, que no tienen ningún sentido fuera de un elemento primario visual que posee una colección adecuada para almacenarlos. Observe que estos casos necesariamente no producen excepciones, porque podría haber escenarios del diseñador que confían en el cambio de elemento primario para los elementos que momentáneamente no tienen sus elementos primarios "normales".

Este método también se invalida en ciertos elementos que son normalmente el elemento raíz, como Window. Otro caso son los elementos que aparentemente constituyen el elemento raíz en el marcado pero generan automáticamente una infraestructura mayor en un árbol lógico compilado (como Page). Las implementaciones de Page y Window sellan deliberadamente el método.

.NET Framework

Compatible con: 4, 3.5, 3.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Mostrar: