FrameworkElement.VisualChildrenCount FrameworkElement.VisualChildrenCount FrameworkElement.VisualChildrenCount FrameworkElement.VisualChildrenCount Property


この要素内でビジュアル子要素の数を取得します。Gets the number of visual child elements within this element.

 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
		Return visualChildren.Count
	End Get
End Property
Protected Overrides Function GetVisualChild(ByVal index As Integer) As Visual
	Return visualChildren(index)
End Function


FrameworkElementの実装VisualChildrenCount常に 0 個または 1 を返します。The FrameworkElement implementation of VisualChildrenCount always returns either zero or one. 1 つを超える可能性のあるビジュアル子コレクションを保持するクラスは、この両方のプロパティをオーバーライドする必要がありますと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.