FrameworkElement.VisualChildrenCount Propriedade

Definição

Obtém o número de elementos filho visuais dentro desse 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 da propriedade

O número de elementos filho visuais para esse elemento.The number of visual child elements for this element.

Exemplos

O exemplo a seguir mostra como um adorner personalizado usa os valores declarados por um VisualCollection que ele mantém para seus vários filhos visuais e relata esses valores por meio de substituições de VisualChildrenCount e 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

Comentários

A implementação de FrameworkElement de VisualChildrenCount sempre retorna zero ou um.The FrameworkElement implementation of VisualChildrenCount always returns either zero or one. As classes que mantêm uma coleção filho visual que pode exceder uma devem substituir essa propriedade e GetVisualChild.Classes that maintain a visual child collection that might exceed one must override both this property and GetVisualChild.

Essa propriedade geralmente é usada para determinar os limites superiores da coleção filho atual para fins de implementação das substituições de layout (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 aos Herdeiros

Se sua classe der suporte a mais de um filho visual em uma coleção de elementos filho, substitua essa propriedade para retornar a contagem de elementos nessa coleção.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. Você deve fazer isso mesmo se o próprio objeto de coleção retornar uma contagem.You must do this even if the collection object itself returns a count. A lógica de layout do elemento no nível do WPF Framework pressupõe que todos os elementos retornarão uma contagem válida por meio de sua propriedade VisualChildrenCount.Element layout logic at the WPF framework level presumes that all elements will return a valid count through their VisualChildrenCount property.

Aplica-se a