FrameworkElement.AddLogicalChild(Object) Метод

Определение

Пространство имен:

System.Windows

Сборка:

PresentationFramework.dll

Добавляет указанный объект в логическое дерево данного элемента.

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)

Параметры

child

Object

Добавляемый дочерний элемент.

Примеры

В следующем примере реализуется свойство в пользовательском ChildFrameworkElement объекте, который выполняет собственную реализацию визуального слоя. Метод задания свойств разработан таким образом, что при изменении значения старое значение удаляется из логического дерева, а также из визуальной коллекции класса. Значение свойства кэшируется, а затем новое значение добавляется как в логическое дерево, так и в коллекцию пользовательских визуальных элементов.

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

Комментарии

Используйте этот метод для реализации коллекций в объектах, представляющих логические дочерние элементы элемента. Обслуживание коллекций для коллекций дочерних элементов может выполняться в методах получения или задания свойств, обработке классов событий Changed, конструкторах или в самих типах коллекции.

Для авторов элементов управления не рекомендуется управлять логическим деревом на этом уровне, если только ни одна из моделей содержимого для доступных базовых классов элементов управления не подходит для вашего сценария управления. Рассмотрите возможность подклассов на уровне ContentControl, ItemsControlи HeaderedItemsControl. Эти классы предоставляют модель содержимого с определенным применением дочерних элементов логического дерева с помощью выделенных API, а также поддержку других функций, обычно желательных в элементе управления WPF, таких как стилизация с помощью шаблонов. Дополнительные сведения об использовании LogicalChildren и AddLogicalChildсм. в разделе Деревья в WPF.

AddLogicalChild при вызове в то время, когда логическое дерево выполняет итерации другим процессом, может вызывать исключение.

См. также раздел

• RemoveLogicalChild(Object)