FrameworkElement.VisualChildrenCount Właściwość

Definicja

Przestrzeń nazw:

System.Windows

Zestaw:

PresentationFramework.dll

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

C#

protected override int VisualChildrenCount { get; }

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.

C#

// To store and manage the adorner's visual children.
VisualCollection visualChildren;

C#

// 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]; }

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.

Dotyczy