Visual.GetVisualChild(Int32) Método

Referencia

Definición

Espacio de nombres:: System.Windows.Media

Ensamblado:: PresentationCore.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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.

Se aplica a

Produto	Versións
.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

Compartir por