FrameworkElement.GetVisualChild(Int32) FrameworkElement.GetVisualChild(Int32) FrameworkElement.GetVisualChild(Int32) FrameworkElement.GetVisualChild(Int32) Method

Definition

Überschreibt GetVisualChild(Int32) und gibt aus einer Auflistung untergeordneter Elemente ein untergeordnetes Element an der angegebenen Indexposition zurück.Overrides GetVisualChild(Int32), and returns a child at the specified index from a collection of child elements.

protected:
 override System::Windows::Media::Visual ^ GetVisualChild(int index);
protected override System.Windows.Media.Visual GetVisualChild (int index);
override this.GetVisualChild : int -> System.Windows.Media.Visual
Protected Overrides Function GetVisualChild (index As Integer) As Visual

Parameter

index
Int32 Int32 Int32 Int32

Der nullbasierte Index des angeforderten untergeordneten Elements in der Auflistung.The zero-based index of the requested child element in the collection.

Gibt zurück

Das angeforderte untergeordnete Element.The requested child element. Es sollte nicht null zurückgeben; wenn der angegebene Index außerhalb des Bereichs liegt, wird eine Ausnahme ausgelöst.This should not return null; if the provided index is out of range, an exception is thrown.

Beispiele

Im folgenden Beispiel wird gezeigt, wie ein benutzerdefinierter Funktions Indikator die von einem VisualCollection deklarierten Werte verwendet, die er für seine verschiedenen visuellen untergeordneten Elemente beibehält.The following example shows how a custom adorner uses the values declared by a VisualCollection that it maintains for its multiple visual children. Diese Werte werden durch über schreibungen von VisualChildrenCount und GetVisualChildgemeldet.These values are reported 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

Hinweise

In der FrameworkElement -Implementierung ist der einzige gültige Index 0 (null).In the FrameworkElement implementation, the only valid index is zero. Das Inhalts Modell für GetVisualChild unterstützt entweder NULL oder ein untergeordnetes Element, keine Auflistung.The content model for GetVisualChild supports either zero or one child elements, not a collection.

Hinweise für Vererber

Diese Implementierung ist nur für Elemente gültig, die keine beschreibende Auflistung von visuellen untergeordneten Elementen beibehalten.This implementation is only valid for elements that do not maintain any more descriptive collection of visual child elements. Alle Elemente, die über eine solche Auflistung verfügen, müssen diese Methode überschreiben und den Index einem entsprechenden Index in der Auflistung der untergeordneten Elemente zuordnen, die von diesem Element unterstützt wird.Any element that does have such a collection must override this method and map the index to an equivalent index in the child element collection that is supported by that element. Ein Index im Bereich von 0 (NULL VisualChildrenCount ) bis (minus 1) sollte ein gültiges Element zurückgeben. jeder andere Index sollte eine Ausnahme außerhalb des gültigen Bereichs auslösen.An index in the range from zero to VisualChildrenCount (minus one) should return a valid element; any other index should throw an out-of-range exception. Ein Beispiel für einen Elementtyp, der eine untergeordnete Auflistung unterstützt, GetVisualChild(Int32) und außer Kraft setzungen, um mehr als Panelein mögliches untergeordnetes Element zurückzugeben, ist.An example of an element type that does support a child collection and overrides GetVisualChild(Int32) to return more than one possible child is Panel.

Die Standard Implementierung in FrameworkElement nimmt nur ein visuelles untergeordnetes Element an.The default implementation in FrameworkElement presumes only one visual child. Jeder Wert, der index für einen anderen Wert als 0 (null) überschritten wird, bewirkt eine AusnahmeAny value passed for index other than zero causes an exception to be thrown. Mehrere allgemeine Elemente, wie z. b. decoratoren, Adorner oder Elemente mit speziellem Rendering FrameworkElement , überschreiben die-Implementierung (der Implementierung von zwischen Basisklassen).Several common elements, such as decorators, adorners, or elements with specialized rendering, override the FrameworkElement implementation (of the implementation from intermediate base classes). Einige Implementierungen erzwingen weiterhin ein visuelles untergeordnetes Element, während andere eine Auflistung erlauben.Some implementations still enforce one visual child whereas others allow a collection.

Gilt für: