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

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

注意 (継承者)

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

適用対象