FrameworkElement.AddLogicalChild(Object) Método

Definição

Adiciona o objeto fornecido à árvore lógica desse 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

Elemento filho a ser adicionado.Child element to be added.

Exemplos

O exemplo a seguir implementa uma propriedade Child em um FrameworkElement personalizado que faz sua própria implementação de camada Visual.The following example implements a Child property on a custom FrameworkElement that does its own visual layer implementation. O setter de propriedade é projetado de forma que, se o valor for alterado, o valor antigo será removido da árvore lógica, bem como uma coleção Visual específica de classe.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. O valor da propriedade é armazenado em cache e, em seguida, o novo valor é adicionado à árvore lógica e à coleção Visual personalizada.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

Comentários

Use este método para a implementação de coleções em objetos que representam elementos filho lógicos de um elemento.Use this method for the implementation of collections on objects that represent logical child elements of an element. A manutenção da coleção para coleções de elementos filho pode ser feita em getters ou setters de propriedade, manipulação de classe de eventos alterados, construtores ou dentro dos próprios tipos de coleção.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.

Para autores de controle, manipular a árvore lógica nesse nível não é a prática recomendada, a menos que nenhum dos modelos de conteúdo para classes de controle base disponíveis seja apropriado para seu cenário de controle.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 a subclasse no nível de ContentControl, ItemsControle HeaderedItemsControl.Consider subclassing at the level of ContentControl, ItemsControl, and HeaderedItemsControl. Essas classes fornecem um modelo de conteúdo com imposição específica de elementos filho da árvore lógica por meio de APIs dedicadas, bem como suporte para outros recursos geralmente desejáveis em um controle de WPFWPF, como estilo por meio de modelos.These classes provide a content model with particular enforcement of logical tree child elements through dedicated APIs, as well as support for other features typically desirable in a WPFWPF control such as styling through templates. Para obter mais informações sobre como usar LogicalChildren e AddLogicalChild, consulte árvores no WPF.For more information on how to use LogicalChildren and AddLogicalChild, see Trees in WPF.

AddLogicalChild poderá lançar uma exceção se for chamado por vez quando a árvore lógica estiver sendo iterada por outro processo.AddLogicalChild may throw an exception if called at a time when the logical tree is being iterated by another process.

Aplica-se a

Veja também