FrameworkElement.VisualChildrenCount 属性

定义

获取此元素中的视觉子元素数。

protected:
 virtual property int VisualChildrenCount { int get(); };
protected override int VisualChildrenCount { get; }
member this.VisualChildrenCount : int
Protected Overrides ReadOnly Property VisualChildrenCount As Integer

属性值

此元素的可视子元素数。

示例

以下示例演示自定义装饰器如何使用它为其多个视觉子级维护的值声明 VisualCollection 的值,并通过重写 VisualChildrenCountGetVisualChild报告这些值。

// 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 返回零或 1 的 VisualChildrenCount 实现。 维护可能超过一个视觉子集合的类必须同时重写此属性和 GetVisualChild

此属性通常用于确定当前子集合的上限,以便实现布局重写 (MeasureOverrideArrangeOverride) 。

继承者说明

如果类支持子元素集合中的多个视觉子级,请重写此属性以返回该集合中的元素计数。 即使集合对象本身返回计数,也必须执行此操作。 WPF框架级别的元素布局逻辑假定所有元素都将通过其 VisualChildrenCount 属性返回有效计数。

适用于