FrameworkElement.AddLogicalChild(Object) Método

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

Exemplos

O exemplo seguinte implementa uma Child propriedade num custom FrameworkElement que faz a sua própria implementação de camada visual. O property setter é concebido de forma a que, se o valor mudar, o valor antigo seja removido da árvore lógica, bem como de uma coleção visual específica de classe. O valor da propriedade é armazenado em cache, e depois o novo valor é adicionado tanto à árvore lógica como à 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

Observações

Use este método para a implementação de coleções em objetos que representem elementos lógicos filhos de um elemento. A manutenção de coleções para coleções de elementos filhos pode ser feita em getters ou setters de propriedade, gestão de eventos alterados por classes, construtores ou dentro dos próprios tipos de coleção.

Para autores de controlos, manipular a árvore lógica a este nível não é a prática recomendada, a menos que nenhum dos modelos de conteúdo para as classes base de controlo disponíveis seja adequado para o seu cenário de controlo. Considere subclasses ao nível de ContentControl, ItemsControl, e HeaderedItemsControl. Estas classes fornecem um modelo de conteúdo com aplicação particular dos elementos filhos da árvore lógica através de APIs dedicadas, bem como suporte para outras funcionalidades normalmente desejáveis num controlo WPF, como o estilo através de templates. Para mais informações sobre como usar LogicalChildren e AddLogicalChild, consulte Trees in WPF.

AddLogicalChild pode lançar uma exceção se chamada num momento em que a árvore lógica está a ser iterada por outro processo.

Ver também

• RemoveLogicalChild(Object)