Visual.GetVisualChild(Int32) Método

Definição

Namespace:

System.Windows.Media

Assembly:

PresentationCore.dll

Retorna o Visual especificado no VisualCollection pai.

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

O índice do objeto visual na VisualCollection.

Retornos

Visual

O filho na VisualCollection no valor de index especificado.

Exemplos

O exemplo a seguir define uma implementação substituída 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

Comentários

Por padrão, um Visual não tem filhos. Portanto, a implementação padrão sempre lança um ArgumentOutOfRangeException.

Notas aos Herdeiros

Uma classe da Visual qual deriva deve substituir esse método e também a VisualChildrenCount propriedade para que a árvore visual seja enumerada corretamente.