FrameworkElement.RemoveLogicalChild(Object) Método

Definição

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Remove o objeto fornecido da árvore lógica desse elemento. O FrameworkElement atualiza os ponteiros pai da árvore lógica afetada para mantê-los em sincronia com essa exclusão.

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

child

Object

O elemento a ser removido.

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 da 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. Os valores são armazenados em cache e, em seguida, o novo valor é adicionado à árvore lógica de nível de estrutura padrão do WPF 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 filhos lógicos de um elemento. Isso pode ser feito em getters ou setters de propriedade, manipuladores de classe de Changed eventos, 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 da classe de controle base fornecidos seja apropriado. Considere a subclasse no nível de ContentControl, ItemsControle HeaderedItemsControl. Essas classes fornecem um modelo de conteúdo com imposição específica de filhos lógicos por meio de APIs dedicadas, bem como suporte para outros recursos normalmente desejáveis em um controle WPF, como estilo por meio de modelos.

Confira também

• AddLogicalChild(Object)