VisualCollection.Add(Visual) Metod

Definition

Namnområde:
System.Windows.Media
Sammansättning:
PresentationCore.dll

Lägger till en Visual i slutet av VisualCollection.

public:
 int Add(System::Windows::Media::Visual ^ visual);
public int Add(System.Windows.Media.Visual visual);
member this.Add : System.Windows.Media.Visual -> int
Public Function Add (visual As Visual) As Integer

Parametrar

visual
Visual

Att Visual lägga till i VisualCollection.

Returer

Int32

Indexet i samlingen där visual lades till.

Undantag

ArgumentException

En ArgumentException genereras om Visual är ett rotelement.

Exempel

I följande exempel visas hur du skapar och VisualCollection lägger till medlemmar i den.

// 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 MyVisualHost : FrameworkElement
{
    // Create a collection of child visual objects.
    private VisualCollection _children;

    public MyVisualHost()
    {
        _children = new VisualCollection(this);
        _children.Add(CreateDrawingVisualRectangle());
        _children.Add(CreateDrawingVisualText());
        _children.Add(CreateDrawingVisualEllipses());

        // Add the event handler for MouseLeftButtonUp.
        this.MouseLeftButtonUp += new System.Windows.Input.MouseButtonEventHandler(MyVisualHost_MouseLeftButtonUp);
    }

' 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 MyVisualHost
    Inherits FrameworkElement
    ' Create a collection of child visual objects.
    Private _children As VisualCollection

    Public Sub New()
        _children = New VisualCollection(Me)
        _children.Add(CreateDrawingVisualRectangle())
        _children.Add(CreateDrawingVisualText())
        _children.Add(CreateDrawingVisualEllipses())

        ' Add the event handler for MouseLeftButtonUp.
        AddHandler MouseLeftButtonUp, AddressOf MyVisualHost_MouseLeftButtonUp
    End Sub

Note

Det fullständiga exemplet finns i Träfftest med DrawingVisuals-exempel.

Kommentarer

Att lägga till ett Visual vars värde är null tillåtet och inte skapar ett undantag.

Metoden Add konfigurerar också relationen mellan överordnad och underordnad mellan det överordnade visuella objektet, som är ägare till VisualCollection, och det underordnade visual.

Om du behöver större kontroll på låg nivå över den underliggande lagringsimplementeringen av visuella underordnade objekt i en anpassad klass bör du överväga att använda AddVisualChild metoderna och RemoveVisualChild . När du använder dessa metoder måste du definiera din egen lagringsimplementering och inte använda VisualCollection.

Gäller för