Visual.AddVisualChild(Visual) Метод

Определение

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

System.Windows.Media

Сборка:

PresentationCore.dll

Определяет связь "родитель-потомок" между двумя визуальными объектами.

C#

protected void AddVisualChild (System.Windows.Media.Visual child);

Параметры

child

Visual

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

Примеры

В следующем примере показано, как определить настраиваемые требования к хранилищу для визуального дочернего элемента. В примере используются AddVisualChild методы и RemoveVisualChild методы для настройки связи "родители-потомки" между родительским визуальным элементом и child. Для правильного перечисления визуального дерева в примере приводятся переопределенные реализации GetVisualChild метода и VisualChildrenCount свойства.

Примечание

Хотя можно использовать VisualCollection для создания отношений "родители-потомки" между визуальными объектами, более эффективно предоставлять собственную реализацию пользовательского хранилища, если только один дочерний элемент связан с родительским объектом.

C#

// Create a host visual derived from the FrameworkElement class.
// This class provides layout, event handling, and container support for
// the child visual object.
public class MyVisualHost : FrameworkElement
{
    private DrawingVisual _child;

    public MyVisualHost(DrawingVisual drawingVisual)
    {
        _child = drawingVisual;
        this.AddVisualChild(_child);
    }

    public DrawingVisual Child
    {
        get
        {
            return _child;
        }

        set
        {
            if (_child != value)
            {
                this.RemoveVisualChild(_child);
                _child = value;
                this.AddVisualChild(_child);
            }
        }
    }

    // Provide a required override for the VisualChildrenCount property.
    protected override int VisualChildrenCount
    {
        get { return _child == null ? 0 : 1; }
    }

    // Provide a required override for the GetVisualChild method.
    protected override Visual GetVisualChild(int index)
    {
        if (_child == null)
        {
            throw new ArgumentOutOfRangeException();
        }

        return _child;
    }

Комментарии

Метод AddVisualChild настраивает связь «родитель-потомок» между двумя визуальными объектами. Этот метод следует использовать, если требуется более низкий уровень управления базовой реализацией хранилища визуальных дочерних объектов. VisualCollection можно использовать в качестве реализации по умолчанию для хранения дочерних объектов.

Применяется к

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

• VisualCollection