FrameworkElement.VisualChildrenCount Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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à
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à.