FrameworkElement.AddLogicalChild(Object) Método

Definição

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Adiciona o objeto fornecido à árvore lógica desse elemento.

C#

protected internal void AddLogicalChild (object child);

Parâmetros

child

Object

Elemento filho a ser adicionado.

Exemplos

O exemplo a seguir implementa uma Child propriedade em um personalizado FrameworkElement que faz sua própria implementação de camada visual. O setter de propriedade foi projetado para que, se o valor for alterado, o valor antigo seja removido da árvore lógica, bem como uma coleção visual específica da classe. O valor da propriedade é armazenado em cache e, em seguida, o novo valor é adicionado à árvore lógica e à coleção 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();
        }
    }
}

Comentários

Use esse método para a implementação de coleções em objetos que representam elementos filho lógicos de um elemento. 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.

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 sejam apropriados para o cenário de controle. Considere a subclasse no nível de ContentControl, ItemsControle HeaderedItemsControl. Essas classes fornecem um modelo de conteúdo com a imposição específica de elementos filho de árvore lógica por meio de APIs dedicadas, bem como suporte para outros recursos normalmente desejáveis em um controle WPF, como estilo por meio de modelos. Para obter mais informações sobre como usar LogicalChildren e AddLogicalChild, consulte Árvores no WPF.

AddLogicalChild pode gerar uma exceção se for chamada em um momento em que a árvore lógica está sendo iterada por outro processo.

Aplica-se a

Confira também

• RemoveLogicalChild(Object)