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

Definición

Obtiene el número de elementos secundarios visuales de este elemento.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

Valor de propiedad

Número de elementos secundarios visuales para este elemento.The number of visual child elements for this element.

Ejemplos

El ejemplo siguiente muestra cómo un adorno personalizado usa los valores declarados por un VisualCollection que mantiene para sus diversos elementos secundarios visuales y notifica estos valores mediante invalidaciones de VisualChildrenCount y GetVisualChild.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

Comentarios

El FrameworkElement implementací VisualChildrenCount siempre devuelve cero o uno.The FrameworkElement implementation of VisualChildrenCount always returns either zero or one. Las clases que mantienen una colección de elementos secundarios que puedan superar uno deben invalidar esta propiedad y GetVisualChild.Classes that maintain a visual child collection that might exceed one must override both this property and GetVisualChild.

Esta propiedad normalmente se usa para determinar los límites superiores de la colección secundaria actual con fines de la implementación de las invalidaciones de diseño (MeasureOverride, ArrangeOverride).This property is generally used to determine the upper bounds of the current child collection for purposes of implementing the layout overrides (MeasureOverride, ArrangeOverride).

Notas a los desarrolladores de herederos

Si su clase admite a más de un elemento secundario visual en una colección de elementos secundarios, invalide esta propiedad para devolver el recuento de elementos de la colección.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. Debe hacerlo incluso si el propio objeto de colección devuelve un recuento.You must do this even if the collection object itself returns a count. Lógica de diseño de elemento en el nivel de marco WPF se da por supuesto que todos los elementos devolverá un recuento válido a través de sus VisualChildrenCount propiedad.Element layout logic at the WPF framework level presumes that all elements will return a valid count through their VisualChildrenCount property.

Se aplica a