FrameworkElement.VisualChildrenCount FrameworkElement.VisualChildrenCount FrameworkElement.VisualChildrenCount FrameworkElement.VisualChildrenCount Property

Definition

Ruft die Anzahl der sichtbaren untergeordneten Elemente innerhalb dieses Elements ab.Gets the number of visual child elements within this element.

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 sichtbaren untergeordneten Elemente für dieses Element.The number of visual child elements for this element.

Beispiele

Im folgenden Beispiel wird gezeigt, wie ein benutzerdefinierter Funktions Indikator die von einem VisualCollection deklarierten Werte verwendet, die für seine untergeordneten visuellen Elemente verwaltet werden, und VisualChildrenCount diese GetVisualChildWerte durch über schreibungen von und meldet.The following example shows how a custom adorner uses the values declared by a VisualCollection that it maintains for its multiple visual children and reports these values through overrides of VisualChildrenCount and 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 VisualChildrenCount von gibt immer entweder 0 (null) oder 1 zurück.The FrameworkElement implementation of VisualChildrenCount always returns either zero or one. Klassen, die eine untergeordnete visuelle Auflistung verwalten, die möglicherweise einen Wert überschreitet GetVisualChild, müssen diese Eigenschaft und überschreiben.Classes that maintain a visual child collection that might exceed one must override both this property and GetVisualChild.

Diese Eigenschaft wird im Allgemeinen verwendet, um die oberen Begrenzungen der aktuellen untergeordneten Auflistung für die Implementierung der layoutüberschreibungsMeasureOverrideVorgänge ArrangeOverride(,) zu bestimmen.This property is generally used to determine the upper bounds of the current child collection for purposes of implementing the layout overrides (MeasureOverride, ArrangeOverride).

Hinweise für Vererber

Wenn Ihre Klasse mehrere visuelle untergeordnete Elemente in einer Auflistung untergeordneter Elemente unterstützt, überschreiben Sie diese Eigenschaft, um die Anzahl der Elemente in dieser Auflistung zurückzugeben.If your class supports more than one visual child in a child element collection, override this property to return the count of elements in that collection. Dies ist auch dann erforderlich, wenn das Sammlungsobjekt selbst eine Anzahl zurückgibt.You must do this even if the collection object itself returns a count. Die elementlayoutlogik auf der WPF-Frameworkebene geht davon aus, dass alle Elemente VisualChildrenCount über Ihre-Eigenschaft eine gültige Anzahl zurückgeben.Element layout logic at the WPF framework level presumes that all elements will return a valid count through their VisualChildrenCount property.

Gilt für: