FrameworkElement.VisualChildrenCount Właściwość

Definicja

Przestrzeń nazw:

System.Windows

Zestaw:

PresentationFramework.dll

Pobiera liczbę elementów podrzędnych wizualizacji w ramach tego elementu.

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

protected override int VisualChildrenCount { get; }

member this.VisualChildrenCount : int

Protected Overrides ReadOnly Property VisualChildrenCount As Integer

Wartość właściwości

Int32

Liczba elementów podrzędnych wizualizacji dla tego elementu.

Przykłady

W poniższym przykładzie pokazano, jak niestandardowy moduł adorujący używa wartości zadeklarowanych przez VisualCollection element , który obsługuje dla wielu elementów podrzędnych wizualizacji i zgłasza te wartości za pośrednictwem przesłonięć VisualChildrenCount elementów i 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

Uwagi

Implementacja FrameworkElementVisualChildrenCount zawsze zwraca zero lub jeden. Klasy, które utrzymują kolekcję elementów podrzędnych wizualizacji, które mogą przekraczać jedną, muszą zastąpić zarówno tę właściwość, jak i GetVisualChild.

Ta właściwość jest zwykle używana do określania górnych granic bieżącej kolekcji podrzędnej na potrzeby implementowania przesłonięć układu (MeasureOverride, ArrangeOverride).

Uwagi dotyczące dziedziczenia

Jeśli klasa obsługuje więcej niż jeden element podrzędny wizualizacji w kolekcji elementów podrzędnych, przesłoń tę właściwość, aby zwrócić liczbę elementów w tej kolekcji. Należy to zrobić nawet wtedy, gdy sam obiekt kolekcji zwraca liczbę. Logika układu elementów na poziomie struktury WPF zakłada, że wszystkie elementy zwracają prawidłową liczbę za pośrednictwem ich VisualChildrenCount właściwości.