Visual.GetVisualChild(Int32) Methode

Referenz

Definition

Namespace:: System.Windows.Media

Assembly:: PresentationCore.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Gibt das angegebene Visual in der übergeordneten VisualCollection zurück.

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

Der Index des visuellen Objekts in der VisualCollection.

Gibt zurück

Visual

Das untergeordnete Element in der VisualCollection am angegebenen index-Wert.

Beispiele

Im folgenden Beispiel wird eine überschriebene Implementierung von GetVisualChilddefiniert.

// 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 verfügt ein Visual über keine untergeordneten Elemente. Daher löst die Standardimplementierung immer eine aus ArgumentOutOfRangeException.

Hinweise für Vererber

Eine Klasse, die von Visual abgeleitet wird, muss diese Methode und auch die VisualChildrenCount -Eigenschaft überschreiben, damit die visuelle Struktur ordnungsgemäß aufgezählt wird.

Gilt für:

Produkt	Versionen
.NET Framework	3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

Freigeben über