FrameworkElement.AddLogicalChild(Object) Método

Definição

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

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

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.

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.

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 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.

Confira também

• RemoveLogicalChild(Object)