FrameworkElement.VisualChildrenCount 속성

정의

이 요소 내 시각적 자식 요소의 수를 가져옵니다.Gets the number of visual child elements within this element.

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

속성 값

이 요소에 대한 시각적 자식 요소의 수입니다.The number of visual child elements for this element.

예제

다음 예제에서는 사용자 지정 표시기가 여러 시각적 자식에 대해 유지 관리 하는 VisualCollection에 의해 선언 된 값을 사용 하 고 VisualChildrenCountGetVisualChild의 재정의를 통해 이러한 값을 보고 하는 방법을 보여 줍니다.The following example shows how a custom adorner uses the values declared by a VisualCollection that it maintains for its multiple visual children and reports these values through overrides of VisualChildrenCount and 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

설명

VisualChildrenCountFrameworkElement 구현은 항상 0 또는 1을 반환 합니다.The FrameworkElement implementation of VisualChildrenCount always returns either zero or one. 하나를 초과할 수 있는 시각적 자식 컬렉션을 유지 관리 하는 클래스는이 속성과 GetVisualChild를 모두 재정의 해야 합니다.Classes that maintain a visual child collection that might exceed one must override both this property and GetVisualChild.

이 속성은 일반적으로 레이아웃 재정의 (MeasureOverrideArrangeOverride)를 구현 하기 위해 현재 자식 컬렉션의 상한을 결정 하는 데 사용 됩니다.This property is generally used to determine the upper bounds of the current child collection for purposes of implementing the layout overrides (MeasureOverride, ArrangeOverride).

상속자 참고

클래스가 자식 요소 컬렉션에서 둘 이상의 시각적 자식을 지 원하는 경우이 속성을 재정의 하 여 해당 컬렉션의 요소 수를 반환 합니다.If your class supports more than one visual child in a child element collection, override this property to return the count of elements in that collection. 컬렉션 개체 자체에서 개수를 반환 하는 경우에도이 작업을 수행 해야 합니다.You must do this even if the collection object itself returns a count. WPF 프레임 워크 수준의 요소 레이아웃 논리는 모든 요소가 VisualChildrenCount 속성을 통해 유효한 개수를 반환 하는 것으로 가정 합니다.Element layout logic at the WPF framework level presumes that all elements will return a valid count through their VisualChildrenCount property.

적용 대상