VisualCollection.Add(Visual) Método

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

Parámetros

Devoluciones

Índice de la colección donde se agregó el objeto especificado por el parámetro visual.

Excepciones

Ejemplos

En el ejemplo siguiente se muestra cómo crear un VisualCollection elemento y agregarle miembros.

// 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

Comentarios

Agregar un Visual cuyo valor está null permitido y no genera una excepción.

El Add método también configura la relación parent-child entre el objeto visual primario, que es el propietario de VisualCollectiony el secundario visual.

Si necesita un mayor control de bajo nivel sobre la implementación de almacenamiento subyacente de objetos secundarios visuales de una clase personalizada, considere la posibilidad de usar los AddVisualChild métodos y RemoveVisualChild . Al usar estos métodos, debe definir su propia implementación de almacenamiento y no usar VisualCollection.

Se aplica a