Visual.GetVisualChild(Int32) Metodo

Definizione

Restituisce l’oggetto Visual specificato nell’oggetto VisualCollection padre.

C#
protected virtual System.Windows.Media.Visual GetVisualChild(int index);

Parametri

index
Int32

Indice del nuovo oggetto visivo nell’oggetto VisualCollection.

Restituisce

L’elemento figlio nell’oggetto VisualCollection al valore index specificato.

Esempio

Nell'esempio seguente viene definita un'implementazione sottoposta a override di GetVisualChild.

C#
// 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];
}

Commenti

Per impostazione predefinita, un oggetto Visual non ha figli. Pertanto, l'implementazione predefinita genera sempre un'eccezione ArgumentOutOfRangeException.

Note per gli eredi

Una classe che deriva da Visual deve eseguire l'override di questo metodo e anche della VisualChildrenCount proprietà affinché l'albero visivo venga enumerato correttamente.

Si applica a

Prodotto Versioni
.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