FrameworkElement.VisualChildrenCount Eigenschaft

Definition

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Ruft die Anzahl der sichtbaren 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

Int32

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

Beispiele

Im folgenden Beispiel wird gezeigt, wie ein benutzerdefinierter Zierer die Von einem VisualCollection benutzerdefinierten Zierer deklarierten Werte verwendet, die für seine mehreren visuellen untergeordneten Elemente verwaltet werden, und meldet diese Werte über Außerkraftsetzungen VisualChildrenCount und 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

Hinweise

Die FrameworkElement Implementierung von VisualChildrenCount immer null oder eins zurück. Klassen, die eine visuelle untergeordnete Auflistung verwalten, die eine überschreitet, müssen sowohl diese Eigenschaft GetVisualChildals auch die .

Diese Eigenschaft wird im Allgemeinen verwendet, um die oberen Grenzen der aktuellen untergeordneten Auflistung für Zwecke der Implementierung der Layoutüberschreibung (MeasureOverride, ArrangeOverride) zu bestimmen.

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. Sie müssen dies auch dann tun, wenn das Auflistungsobjekt selbst eine Anzahl zurückgibt. Elementlayoutlogik auf WPF-Frameworkebene geht davon aus, dass alle Elemente eine gültige Anzahl über ihre VisualChildrenCount Eigenschaft zurückgeben.