FrameworkElement.VisualChildrenCount プロパティ

定義

名前空間:

System.Windows

アセンブリ:

PresentationFramework.dll

この要素内でビジュアル子要素の数を取得します。

C#

protected override int VisualChildrenCount { get; }

プロパティ値

Int32

この要素のビジュアル子要素の数。

例

次の例は、カスタム装飾が、複数のビジュアル子に対して保持する によってVisualCollection宣言された値を使用し、 と GetVisualChildのオーバーライドを使用してこれらの値を報告するVisualChildrenCount方法を示しています。

C#

// To store and manage the adorner's visual children.
VisualCollection visualChildren;

C#

// 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]; }

注釈

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

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

注意 (継承者)

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

適用対象