FrameworkElement.RemoveLogicalChild(Object) Método

Definición

Espacio de nombres:

System.Windows

Ensamblado:

PresentationFramework.dll

Quita el objeto proporcionado del árbol lógico de este elemento. FrameworkElement actualiza los punteros primarios correspondientes del árbol lógico para mantenerlos sincronizados con esta eliminación.

C#

protected internal void RemoveLogicalChild(object child);

Parámetros

child

Object

Elemento que se va a quitar.

Ejemplos

En el ejemplo siguiente se implementa una Child propiedad en un personalizado FrameworkElement que realiza su propia implementación de capa visual. El establecedor de la propiedad está diseñado para que, si el valor cambia, el valor anterior se quita del árbol lógico, así como una colección visual específica de clase. Los valores se almacenan en caché y, a continuación, el nuevo valor se agrega tanto al árbol lógico de nivel de marco de WPF estándar como a la colección visual personalizada.

C#

public virtual UIElement Child
{
    get
    {
        return _child;
    }
    set
    {
        if (_child != value)
        {
            //need to remove old element from logical tree
            if (_child != null)
            {
                OnDetachChild(_child);
                RemoveLogicalChild(_child);
            }

            _vc.Clear();

            if (value != null)
            {
                //add to visual
                _vc.Add(value);
                //add to logical
                AddLogicalChild(value);
            }

            //always add the overlay child back into the visual tree if its set
            if (_overlayVisual != null)
                _vc.Add(_overlayVisual);

            //cache the new child
            _child = value;

            //notify derived types of the new child
            if (value != null)
                OnAttachChild(_child);

            InvalidateMeasure();
        }
    }
}

Comentarios

Utilice este método para la implementación de colecciones en objetos que representan elementos secundarios lógicos de un elemento. Esto puede hacerse en captadores de propiedades o establecedores, controladores de clases de Changed eventos, constructores o dentro de los propios tipos de colección.

Para los autores de controles, manipular el árbol lógico en este nivel no es la práctica recomendada, a menos que ninguno de los modelos de contenido de la clase de control base proporcionados sea adecuado. Considere la posibilidad de subclases en el nivel de ContentControl, ItemsControly HeaderedItemsControl. Estas clases proporcionan un modelo de contenido con una aplicación concreta de elementos secundarios lógicos a través de API dedicadas, así como compatibilidad con otras características que normalmente son deseables en un control WPF, como aplicar estilos a través de plantillas.

Se aplica a

Consulte también

• AddLogicalChild(Object)