VisualCollection.Add(Visual) Método

Definición

Espacio de nombres:
System.Windows.Media
Ensamblado:
PresentationCore.dll

Anexa un Visual objeto al final de .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

Parámetros

visual
Visual

que Visual se va a anexar a .VisualCollection

Devoluciones

Int32

Índice de la colección en la que visual se agregó.

Excepciones

ArgumentException

ArgumentException Se produce una excepción si Visual es un elemento raíz.

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

Note

Para obtener el ejemplo completo, consulte Prueba de posicionamiento mediante drawingVisuals Sample.

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