FrameworkElement.VisualChildrenCount Propriedade

Definição

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Obtém o número de elementos filho visuais dentro desse elemento.

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

Int32

O número de elementos filho visuais para esse elemento.

Exemplos

O exemplo a seguir mostra como um adorno 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.

// 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 FrameworkElement implementação de VisualChildrenCount sempre retorna zero ou um. Classes que mantêm uma coleção filho visual que pode exceder uma devem substituir essa propriedade e 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).

Notas aos Herdeiros

Se a 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. Você deve fazer isso mesmo que o próprio objeto de coleção retorne uma contagem. A lógica de layout de elemento no nível da estrutura do WPF presume que todos os elementos retornarão uma contagem válida por meio de sua VisualChildrenCount propriedade.