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宣言された値を使用し、 と GetVisualChildのオーバーライドを使用してこれらの値を報告するVisualChildrenCount方法を示しています。

// 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

注釈

VisualChildrenCount実装ではFrameworkElement、常に 0 または 1 が返されます。 1 を超える可能性があるビジュアル子コレクションを保持するクラスは、このプロパティと GetVisualChildの両方をオーバーライドする必要があります。

このプロパティは、通常、レイアウトのオーバーライド (MeasureOverrideArrangeOverride) を実装する目的で、現在の子コレクションの上限を決定するために使用されます。

注意 (継承者)

クラスで子要素コレクション内の複数のビジュアル子がサポートされている場合は、このプロパティをオーバーライドして、そのコレクション内の要素の数を返します。 コレクション オブジェクト自体がカウントを返す場合でも、これを行う必要があります。 WPF フレームワーク レベルの要素レイアウト ロジックでは、すべての要素がプロパティを通じて VisualChildrenCount 有効な数を返すと仮定します。

適用対象