FrameworkElement.VisualChildrenCount Proprietà

Definizione

Ottiene il numero di elementi figlio visivi in questo 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

Valore della proprietà

Int32

Numero di elementi figlio visivi per questo elemento.The number of visual child elements for this element.

Esempio

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

Commenti

L' FrameworkElement implementazione di VisualChildrenCount restituisce sempre zero o uno.The FrameworkElement implementation of VisualChildrenCount always returns either zero or one. Le classi che gestiscono una raccolta figlio visiva che potrebbe superarne una devono eseguire l'override di questa proprietà e di GetVisualChild .Classes that maintain a visual child collection that might exceed one must override both this property and GetVisualChild.

Questa proprietà viene in genere utilizzata per determinare i limiti superiori della raccolta figlio corrente allo scopo di implementare gli override del 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).

Note per gli eredi

Se la classe supporta più elementi figlio visivi in una raccolta di elementi figlio, eseguire l'override di questa proprietà per restituire il numero di elementi nella raccolta.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. È necessario eseguire questa operazione anche se l'oggetto della raccolta restituisce un conteggio.You must do this even if the collection object itself returns a count. La logica di layout degli elementi a livello di Framework WPF presuppone che tutti gli elementi restituiscano un conteggio valido tramite la relativa VisualChildrenCount Proprietà.Element layout logic at the WPF framework level presumes that all elements will return a valid count through their VisualChildrenCount property.

Si applica a