ContainerVisual.GetVisualChild(Int32) Méthode

Définition

Espace de noms:

System.Windows.Media

Assembly:

PresentationCore.dll

Retourne un Visual enfant spécifié pour le ContainerVisual parent.

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

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

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

Protected Overrides NotOverridable Function GetVisualChild (index As Integer) As Visual

Paramètres

index

Int32

Entier 32 bits signé qui représente la valeur d’index du Visual enfant. La valeur de index doit être comprise entre 0 et VisualChildrenCount - 1.

Retours

Visual

Visual enfant.

Exemples

L’exemple suivant montre comment créer un ContainerVisual objet utilisé comme parent pour deux DrawingVisual objets. Les objets ajoutés à l’objet ContainerVisual doivent être ajoutés dans l’ordre de plan inverse (inférieur à supérieur) pour s’assurer qu’ils sont affichés dans l’ordre de dessin correct. Pour que l’arborescence visuelle soit énumérée correctement, l’exemple fournit des implémentations substituées de la méthode et VisualChildrenCount de la GetVisualChild propriété.

// Create a host visual derived from the FrameworkElement class.
// This class provides layout, event handling, and container support for
// the child visual objects.
public class MyContainerVisualHost : FrameworkElement
{
    private ContainerVisual _containerVisual;

    public MyContainerVisualHost(DrawingVisual border, DrawingVisual text)
    {
        // Create a ContainerVisual to hold DrawingVisual children.
        _containerVisual = new ContainerVisual();

        // Add children to ContainerVisual in reverse z-order (bottom to top).
        _containerVisual.Children.Add(border);
        _containerVisual.Children.Add(text);

        // Create parent-child relationship with host visual and ContainerVisual.
        this.AddVisualChild(_containerVisual);
    }

    // Provide a required override for the VisualChildrenCount property.
    protected override int VisualChildrenCount
    {
        get { return _containerVisual == null ? 0 : 1; }
    }

    // Provide a required override for the GetVisualChild method.
    protected override Visual GetVisualChild(int index)
    {
        if (_containerVisual == null)
        {
            throw new ArgumentOutOfRangeException();
        }

        return _containerVisual;
    }
}

' Create a host visual derived from the FrameworkElement class.
' This class provides layout, event handling, and container support for
' the child visual objects.
Public Class MyContainerVisualHost
    Inherits FrameworkElement
    Private _containerVisual As ContainerVisual

    Public Sub New(ByVal border As DrawingVisual, ByVal text As DrawingVisual)
        ' Create a ContainerVisual to hold DrawingVisual children.
        _containerVisual = New ContainerVisual()

        ' Add children to ContainerVisual in reverse z-order (bottom to top).
        _containerVisual.Children.Add(border)
        _containerVisual.Children.Add(text)

        ' Create parent-child relationship with host visual and ContainerVisual.
        Me.AddVisualChild(_containerVisual)
    End Sub

    ' Provide a required override for the VisualChildrenCount property.
    Protected Overrides ReadOnly Property VisualChildrenCount() As Integer
        Get
            Return If(_containerVisual Is Nothing, 0, 1)
        End Get
    End Property

    ' Provide a required override for the GetVisualChild method.
    Protected Overrides Function GetVisualChild(ByVal index As Integer) As Visual
        If _containerVisual Is Nothing Then
            Throw New ArgumentOutOfRangeException()
        End If

        Return _containerVisual
    End Function
End Class

Remarques

Par défaut, un ContainerVisual n’a pas d’enfants.

Notes pour les héritiers

L’arborescence visuelle ne peut pas être modifiée pendant cet appel.

Voir aussi

• VisualChildrenCount