Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método FrameworkElement.OnVisualParentChanged (DependencyObject)

 

Publicado: octubre de 2016

Se invoca cuando se cambia el elemento primario de este elemento en el árbol visual. Invalida OnVisualParentChanged.

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

protected internal override void OnVisualParentChanged(
	DependencyObject oldParent
)

Parámetros

oldParent
Type: System.Windows.DependencyObject

Elemento primario anterior. Puede ser null para indicar que el elemento no tiene un elemento primario visual previamente.

El árbol visual es potencialmente diferente del árbol lógico porque omite los elementos que no se representan visualmente, como colecciones y expande algunos elementos según su composición de tema y estilo. Para obtener más información, consulte árboles en WPF.

Notas para desarrolladores de herederos:

La implementación predeterminada de este método virtual consulta el nuevo elemento primario, provoca varios eventos de inicialización y establece los marcadores internos sobre el estado de inicialización de la FrameworkElement según corresponda. Por último, 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 elemento para este elemento cuando se declara como un elemento secundario de otro elemento no puede ser según lo esperado.

Unos existente Windows Presentation Foundation (WPF) clases reemplazar este método, por ejemplo: Window.OnVisualParentChanged, ListBoxItem.OnVisualParentChanged. El escenario más común es exigir que el nuevo elemento primario debe ser un tipo determinado. Esto puede implicar a producir una excepción si el nuevo elemento primario 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. Tenga en cuenta que estos casos no necesariamente provocan excepciones, porque podría haber escenarios del diseñador que se basan en elementos que momentáneamente sin sus elementos primarios "normales" para cambiar.

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

.NET Framework
Disponible desde 3.0
Volver al principio
Mostrar: