FrameworkElement.VisualChildrenCount Propriété

Définition

Espace de noms:

System.Windows

Assembly:

PresentationFramework.dll

Obtient le nombre d’éléments enfants visuels dans cet élément.

protected:
 virtual property int VisualChildrenCount { int get(); };

protected override int VisualChildrenCount { get; }

member this.VisualChildrenCount : int

Protected Overrides ReadOnly Property VisualChildrenCount As Integer

Valeur de propriété

Int32

Nombre d’éléments enfants visuels pour cet élément.

Exemples

L’exemple suivant montre comment un ornement personnalisé utilise les valeurs déclarées par un VisualCollection qu’il gère pour ses enfants visuels multiples et signale ces valeurs via des remplacements de VisualChildrenCount et 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

Remarques

L’implémentation FrameworkElement de VisualChildrenCount toujours retourne zéro ou un. Classes qui conservent une collection enfant visuelle qui peut dépasser un doit remplacer cette propriété et GetVisualChild.

Cette propriété est généralement utilisée pour déterminer les limites supérieures de la collection enfant actuelle à des fins d’implémentation des remplacements de disposition (MeasureOverride, ArrangeOverride).

Notes pour les héritiers

Si votre classe prend en charge plusieurs enfants visuels dans une collection d’éléments enfants, remplacez cette propriété pour renvoyer le nombre d’éléments de cette collection. Vous devez le faire même si l’objet de collection lui-même retourne un nombre. La logique de disposition des éléments au niveau de l’infrastructure WPF suppose que tous les éléments retournent un nombre valide par le biais de leur VisualChildrenCount propriété.