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.

C#

protected internal void RemoveLogicalChild(object child);

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.

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

Aplica-se a

Confira também

• AddLogicalChild(Object)