Auf Englisch lesen

Freigeben über


FrameworkElement.VisualChildrenCount Eigenschaft

Definition

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

C#
protected override int VisualChildrenCount { get; }

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.

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

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.

Gilt für

Produkt Versionen
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
Windows Desktop 3.0, 3.1, 5, 6, 7