FrameworkElement.VisualChildrenCount Eigenschaft

Definition

Ruft die Anzahl der visuellen untergeordneten Elemente innerhalb dieses Elements ab.

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

Eigenschaftswert

Die Anzahl der visuellen untergeordneten Elemente für dieses Element.

Beispiele

Das folgende Beispiel zeigt, wie ein benutzerdefinierter Zierer die Von einem VisualCollection benutzerdefinierten Zierer deklarierten Werte verwendet, die für seine mehrere visuellen untergeordneten Elemente verwaltet werden, und meldet diese Werte über Außerkraftsetzungen und VisualChildrenCountGetVisualChild.

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

Hinweise

Die FrameworkElement Implementierung von VisualChildrenCount always returns either zero or one. Klassen, die eine visuelle untergeordnete Auflistung beibehalten, die eine überschreitet, müssen sowohl diese Eigenschaft GetVisualChildals auch die .

Diese Eigenschaft wird in der Regel verwendet, um die oberen Grenzen der aktuellen untergeordneten Auflistung zu bestimmen, um die Layoutüberschreibungen (MeasureOverride, ArrangeOverride) zu implementieren.

Hinweise für Vererber

Wenn Ihre Klasse mehr als ein visuelles untergeordnetes Element in einer untergeordneten Elementsammlung unterstützt, überschreiben Sie diese Eigenschaft, um die Anzahl der Elemente in dieser Auflistung zurückzugeben. Dies müssen Sie auch dann tun, wenn das Auflistungsobjekt selbst eine Anzahl zurückgibt. Die Elementlayoutlogik auf WPF Frameworkebene geht davon aus, dass alle Elemente eine gültige Anzahl über ihre VisualChildrenCount-Eigenschaft zurückgeben.

Gilt für: