FrameworkElement.VisualChildrenCount Свойство

Определение

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

System.Windows

Сборка:

PresentationFramework.dll

Получает количество визуальных дочерних элементов внутри этого элемента.

protected:
 virtual property int VisualChildrenCount { int get(); };

protected override int VisualChildrenCount { get; }

member this.VisualChildrenCount : int

Protected Overrides ReadOnly Property VisualChildrenCount As Integer

Значение свойства

Int32

Количество визуальных дочерних элементов для этого элемента.

Примеры

В следующем примере показано, как пользовательский графический элемент использует значения, объявленные VisualCollection для нескольких визуальных дочерних элементов, и сообщает об этих значениях с помощью переопределений VisualChildrenCount и GetVisualChild.

// To store and manage the adorner's visual children.
VisualCollection visualChildren;

' To store and manage the adorner's visual children.
Private visualChildren As VisualCollection

// Override the VisualChildrenCount and GetVisualChild properties to interface with 
// the adorner's visual collection.
protected override int VisualChildrenCount { get { return visualChildren.Count; } }
protected override Visual GetVisualChild(int index) { return visualChildren[index]; }

' Override the VisualChildrenCount and GetVisualChild properties to interface with 
' the adorner's visual collection.
Protected Overrides ReadOnly Property VisualChildrenCount() As Integer
    Get
        Return visualChildren.Count
    End Get
End Property
Protected Overrides Function GetVisualChild(ByVal index As Integer) As Visual
    Return visualChildren(index)
End Function

Комментарии

Реализация FrameworkElement VisualChildrenCount всегда возвращает либо ноль, либо одну. Классы, поддерживающие визуальную дочернюю коллекцию, которая может превышать одну из них, необходимо переопределить как это свойство, так и GetVisualChild.

Это свойство обычно используется для определения верхних границ текущей дочерней коллекции для реализации переопределения макета (MeasureOverride, ArrangeOverride).

Примечания для тех, кто наследует этот метод

Если класс поддерживает несколько визуальных дочерних элементов в коллекции дочерних элементов, переопределите это свойство, чтобы вернуть количество элементов в этой коллекции. Это необходимо сделать, даже если сам объект коллекции возвращает счетчик. Логика макета элементов на уровне платформы WPF предполагает, что все элементы будут возвращать допустимое количество через их VisualChildrenCount свойство.