Visual.GetVisualChild(Int32) Visual.GetVisualChild(Int32) Visual.GetVisualChild(Int32) Visual.GetVisualChild(Int32) Method

Definition

Gibt das angegebene Visual in der übergeordneten VisualCollection zurück.Returns the specified Visual in the parent VisualCollection.

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

Parameter

index
Int32 Int32 Int32 Int32

Der Index des visuellen Objekts in der VisualCollection.The index of the visual object in the VisualCollection.

Gibt zurück

Das untergeordnete Element in der VisualCollection am angegebenen index-Wert.The child in the VisualCollection at the specified index value.

Beispiele

Das folgende Beispiel definiert eine überschriebene Implementierung der GetVisualChild.The following example defines an overridden implementation of GetVisualChild.

// Provide a required override for the GetVisualChild method.
protected override Visual GetVisualChild(int index)
{
    if (index < 0 || index >= _children.Count)
    {
        throw new ArgumentOutOfRangeException();
    }

    return _children[index];
}
' Provide a required override for the GetVisualChild method.
Protected Overrides Function GetVisualChild(ByVal index As Integer) As Visual
	If index < 0 OrElse index >= _children.Count Then
		Throw New ArgumentOutOfRangeException()
	End If

	Return _children(index)
End Function

Hinweise

Standardmäßig eine Visual hat keine untergeordneten Elemente.By default, a Visual has no children. Aus diesem Grund die standardmäßige Implementierung löst immer eine ArgumentOutOfRangeException.Therefore, the default implementation always throws an ArgumentOutOfRangeException.

Hinweise für Vererber

Eine abgeleitete Klasse Visual müssen diese Methode überschreiben und die VisualChildrenCount Eigenschaft, für die visuelle Struktur ordnungsgemäß aufgelistet werden sollen.A class that derives from Visual must override this method, and also the VisualChildrenCount property, for the visual tree to be enumerated correctly.

Gilt für: