FrameworkElement.VisualChildrenCount Propriété

Définition

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

C#
protected override int VisualChildrenCount { get; }

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.

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

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é.

S’applique à

Produit Versions
.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