Visual.GetVisualChild(Int32) Método

Definición

Espacio de nombres:

System.Windows.Media

Ensamblado:

PresentationCore.dll

Devuelve el especificado Visual en el elemento primario 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

Parámetros

index

Int32

Índice del objeto visual en .VisualCollection

Devoluciones

Visual

Elemento secundario en en el VisualCollection valor especificado index .

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 no Visual tiene elementos secundarios. Por lo tanto, la implementación predeterminada siempre produce una ArgumentOutOfRangeExceptionexcepción .

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.