FrameworkElement.VisualChildrenCount Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene el número de elementos secundarios visuales de este elemento.
protected:
virtual property int VisualChildrenCount { int get(); };protected override int VisualChildrenCount { get; }member this.VisualChildrenCount : intProtected Overrides ReadOnly Property VisualChildrenCount As IntegerValor de propiedad
Número de elementos secundarios visuales para este elemento.
Ejemplos
En el ejemplo siguiente se muestra cómo un adorno personalizado usa los valores declarados por un VisualCollection objeto que mantiene para sus varios elementos secundarios visuales e informa de estos valores a través de invalidaciones de VisualChildrenCount y 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
La FrameworkElement implementación de VisualChildrenCount siempre devuelve cero o uno. Las clases que mantienen una colección secundaria visual que puede superar una deben invalidar esta propiedad y GetVisualChild.
Esta propiedad se usa generalmente para determinar los límites superiores de la colección secundaria actual con el fin de implementar las invalidaciones de diseño (MeasureOverride, ArrangeOverride).
Notas a los desarrolladores de herederos
Si la clase admite más de un elemento secundario visual en una colección de elementos secundarios, invalide esta propiedad para devolver el recuento de elementos de esa colección. Debe hacerlo incluso si el propio objeto de colección devuelve un recuento. La lógica de diseño de elementos en el nivel de marco de WPF supone que todos los elementos devolverán un recuento válido a través de su VisualChildrenCount propiedad.
