VisualCollection.Add(Visual) Método

Definición

Espacio de nombres:

System.Windows.Media

Ensamblado:

PresentationCore.dll

Anexa un objeto Visual 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

Clase Visual que se va a anexar a la colección VisualCollection.

Devoluciones

Int32

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

Excepciones

ArgumentException

Se produce una excepción ArgumentException 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

Nota:

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