Visual.GetVisualChild(Int32) Método

Definición

Espacio de nombres:

System.Windows.Media

Ensamblado:

PresentationCore.dll

Devuelve el objeto Visual especificado de la colección VisualCollection primaria.

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

Parámetros

index

Int32

Valor de índice del objeto visual de VisualCollection.

Devoluciones

Visual

Objeto secundario del objeto VisualCollection en el valor de index especificado.

Ejemplos

En el ejemplo siguiente se define una implementación invalidada de 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

Comentarios

De forma predeterminada, un Visual no tiene elementos secundarios. Por lo tanto, la implementación predeterminada siempre produce un ArgumentOutOfRangeException.

Notas a los desarrolladores de herederos

Una clase que deriva de Visual debe invalidar este método, y también la VisualChildrenCount propiedad , para que el árbol visual se enumere correctamente.