FrameworkElement.RemoveLogicalChild(Object) Método

protected public:
 void RemoveLogicalChild(System::Object ^ child);

protected internal void RemoveLogicalChild(object child);

member this.RemoveLogicalChild : obj -> unit

Protected Friend Sub RemoveLogicalChild (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 setter da propriedade é concebido para 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. Os valores são armazenados em cache e, depois, o novo valor é adicionado tanto à árvore lógica padrão ao nível do framework WPF 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 filhos lógicos de um elemento. Isto pode ser feito em proprietários ou setters, gestores de classes de Changed eventos, construtores ou dentro dos próprios tipos de coleção.

Para autores de controlo, manipular a árvore lógica a este nível não é a prática recomendada, a menos que nenhum dos modelos de conteúdo da classe de controlo base fornecida seja apropriado. Considere subclasses ao nível de ContentControl, ItemsControl, e HeaderedItemsControl. Estas classes fornecem um modelo de conteúdo com aplicação particular de filhos lógicos através de APIs dedicadas, bem como suporte para outras funcionalidades normalmente desejáveis num controlo WPF, como o estilo através de templates.

Ver também

• AddLogicalChild(Object)