FrameworkElement.GetVisualChild(Int32) Método

protected:
 override System::Windows::Media::Visual ^ GetVisualChild(int index);

protected override System.Windows.Media.Visual GetVisualChild(int index);

override this.GetVisualChild : int -> System.Windows.Media.Visual

Protected Overrides Function GetVisualChild (index As Integer) As Visual

Parâmetros

Devoluções

O elemento filho pedido. Isto não deve devolver null; se o índice fornecido estiver fora do intervalo, é lançada uma exceção.

Exemplos

O exemplo seguinte mostra como um adorner personalizado usa os valores declarados por a VisualCollection que mantém para os seus múltiplos filhos visuais. Estes valores são reportados através de sobreposições de VisualChildrenCount e GetVisualChild.

// To store and manage the adorner's visual children.
VisualCollection visualChildren;

' To store and manage the adorner's visual children.
Private visualChildren As VisualCollection

// Override the VisualChildrenCount and GetVisualChild properties to interface with 
// the adorner's visual collection.
protected override int VisualChildrenCount { get { return visualChildren.Count; } }
protected override Visual GetVisualChild(int index) { return visualChildren[index]; }

' Override the VisualChildrenCount and GetVisualChild properties to interface with 
' the adorner's visual collection.
Protected Overrides ReadOnly Property VisualChildrenCount() As Integer
    Get
        Return visualChildren.Count
    End Get
End Property
Protected Overrides Function GetVisualChild(ByVal index As Integer) As Visual
    Return visualChildren(index)
End Function

Observações

Na FrameworkElement implementação, o único índice válido é zero. O modelo de conteúdo para GetVisualChild suporta zero ou um elemento filho, não uma coleção.

Notas para Herdeiros

Esta implementação só é válida para elementos que não mantêm mais uma coleção descritiva de elementos visuais filhos. Qualquer elemento que tenha tal coleção deve sobrepor este método e mapear o índice para um índice equivalente na coleção de elementos filho suportada por esse elemento. Um índice no intervalo de zero a VisualChildrenCount (menos um) deve devolver um elemento válido; qualquer outro índice deve lançar uma exceção fora do intervalo. Um exemplo de um tipo de elemento que suporta uma coleção de filhos e substitui GetVisualChild(Int32) para devolver mais do que um filho possível é Panel.

A implementação padrão em FrameworkElement presume apenas um filho visual. Qualquer valor passado para index outro que não zero provoca uma exceção. Vários elementos comuns, como decoradores, adornadores ou elementos com renderização especializada, sobrepõem-se à FrameworkElement implementação (da implementação a partir de classes base intermédias). Algumas implementações ainda exigem um filho visual, enquanto outras permitem uma coleção.