FrameworkElement.VisualChildrenCount Proprietà

Definizione

Spazio dei nomi:

System.Windows

Assembly:

PresentationFramework.dll

Ottiene il numero di elementi figlio visivi in questo elemento.

protected:
 virtual property int VisualChildrenCount { int get(); };

protected override int VisualChildrenCount { get; }

member this.VisualChildrenCount : int

Protected Overrides ReadOnly Property VisualChildrenCount As Integer

Valore della proprietà

Int32

Numero di elementi figlio visivi per questo elemento.

Esempio

Nell'esempio seguente viene illustrato come uno strumento decorativo personalizzato usi i valori dichiarati da un VisualCollection oggetto che gestisce per più elementi figlio visivi e segnala questi valori tramite override di 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

Commenti

L'implementazione FrameworkElement di VisualChildrenCount restituisce sempre zero o uno. Le classi che gestiscono una raccolta figlio visiva che potrebbe superare uno devono eseguire l'override sia di questa proprietà GetVisualChildche di .

Questa proprietà viene in genere utilizzata per determinare i limiti superiori della raccolta figlio corrente ai fini dell'implementazione degli override del layout (MeasureOverride, ArrangeOverride).

Note per gli eredi

Se la classe supporta più oggetti figlio visivi in una raccolta di elementi figlio, eseguire l'override di questa proprietà per restituire il numero di elementi in tale raccolta. È necessario eseguire questa operazione anche se l'oggetto raccolta stesso restituisce un conteggio. La logica di layout degli elementi a livello di framework WPF presuppone che tutti gli elementi restituiranno un conteggio valido tramite la relativa VisualChildrenCount proprietà.