FrameworkElement.AddLogicalChild(Object) FrameworkElement.AddLogicalChild(Object) FrameworkElement.AddLogicalChild(Object) FrameworkElement.AddLogicalChild(Object) Method

Definición

Agrega el objeto proporcionado al árbol lógico de este elemento.Adds the provided object to the logical tree of this element.

protected public:
 void AddLogicalChild(System::Object ^ child);
protected internal void AddLogicalChild (object child);
member this.AddLogicalChild : obj -> unit
Protected Friend Sub AddLogicalChild (child As Object)

Parámetros

child
Object Object Object Object

Elemento secundario que se va a agregar.Child element to be added.

Ejemplos

En el ejemplo siguiente se implementa Child una propiedad en un FrameworkElement personalizado que realiza su propia implementación de la capa visual.The following example implements a Child property on a custom FrameworkElement that does its own visual layer implementation. El establecedor de propiedad está diseñado de modo que, si el valor cambia, el valor anterior se quita del árbol lógico, así como de una colección visual específica de la clase.The property setter is designed so that if the value changes, the old value is removed from the logical tree, as well as a class-specific visual collection. El valor de la propiedad se almacena en caché y, a continuación, el nuevo valor se agrega al árbol lógico y a la colección de objetos visuales personalizados.The property value is cached, and then the new value is added to both the logical tree and the custom visual collection.

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();
        }
    }
}
<System.ComponentModel.DefaultValue(GetType(Object), Nothing)>
Public Overridable Property Child() As UIElement
    Get
        Return _child
    End Get
    Set(ByVal value As UIElement)
        If _child IsNot value Then
            'need to remove old element from logical tree
            If _child IsNot Nothing Then
                OnDetachChild(_child)
                RemoveLogicalChild(_child)
            End If

            _vc.Clear()

            If value IsNot Nothing Then
                'add to visual
                _vc.Add(value)
                'add to logical
                AddLogicalChild(value)
            End If

            'always add the overlay child back into the visual tree if its set
            If _overlayVisual IsNot Nothing Then
                _vc.Add(_overlayVisual)
            End If

            'cache the new child
            _child = value

            'notify derived types of the new child
            If value IsNot Nothing Then
                OnAttachChild(_child)
            End If

            InvalidateMeasure()
        End If
    End Set
End Property

Comentarios

Utilice este método para la implementación de colecciones en objetos que representan los elementos secundarios lógicos de un elemento.Use this method for the implementation of collections on objects that represent logical child elements of an element. El mantenimiento de las colecciones de elementos secundarios puede realizarse en captadores o establecedores de propiedad, control de clases de eventos modificados, constructores o dentro de los propios tipos de colección.Collection maintenance for child element collections might be done in property getters or setters, class handling of Changed events, constructors, or within the collection types themselves.

En el caso de los autores de controles, no es recomendable manipular el árbol lógico en este nivel, a menos que ninguno de los modelos de contenido para las clases de control base disponibles sea adecuado para el escenario de control.For control authors, manipulating the logical tree at this level is not the recommended practice, unless none of the content models for available base control classes are appropriate for your control scenario. Considere la posibilidad de subclases en ContentControlel ItemsControlnivel de HeaderedItemsControl, y.Consider subclassing at the level of ContentControl, ItemsControl, and HeaderedItemsControl. Estas clases proporcionan un modelo de contenido con una aplicación concreta de elementos secundarios de árbol APIAPIslógico a través de dedicado, así como compatibilidad con otras características WPFWPF que suelen ser deseables en un control, como la aplicación de estilos a través de plantillas.These classes provide a content model with particular enforcement of logical tree child elements through dedicated APIAPIs, as well as support for other features typically desirable in a WPFWPF control such as styling through templates. Para obtener más información sobre cómo usar LogicalChildren y AddLogicalChild, vea árboles en WPF.For more information on how to use LogicalChildren and AddLogicalChild, see Trees in WPF.

AddLogicalChildpuede producir una excepción si se llama en el momento en que otro proceso está iterando en el árbol lógico.AddLogicalChild may throw an exception if called at a time when the logical tree is being iterated by another process.

Se aplica a

Consulte también: