FrameworkElement.VisualChildrenCount Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.