VisualCollection.Insert(Int32, Visual) VisualCollection.Insert(Int32, Visual) VisualCollection.Insert(Int32, Visual) Method

Definición

Inserta un elemento en VisualCollection en el índice especificado.Inserts an element into the VisualCollection at the specified index.

public:
 void Insert(int index, System::Windows::Media::Visual ^ visual);
public void Insert (int index, System.Windows.Media.Visual visual);
member this.Insert : int * System.Windows.Media.Visual -> unit

Parámetros

index
Int32 Int32 Int32

Índice de base cero donde se va a insertar el valor.The zero-based index at which the value should be inserted.

visual
Visual Visual Visual

Objeto Visual que se va a insertar en VisualCollection.The Visual to insert into the VisualCollection.

Excepciones

index es menor que cero o mayor que Count.index is less than zero or greater than Count.

Comentarios

Si Count ya es Capacityigual a VisualCollection , se aumenta la capacidad de antes de que Visual se inserte el nuevo.If Count already equals Capacity, the capacity of the VisualCollection is increased before the new Visual is inserted. Si index es igual a Count, visual se agrega al final de VisualCollection.If index is equal to Count, visual is added to the end of VisualCollection. Cualquier objeto visual existente que sea igual o mayor index que se desplazará para acomodar el nuevo Visual, y sus valores de índice se actualizarán.Any existing visual objects that are equal to or greater than index are shifted to accommodate the new Visual, and their index values are updated.

El Insert método también configura la relación de elementos primarios y secundarios entre el objeto visual primario, que es el VisualCollectionpropietario de y el visualelemento secundario.The Insert method also sets up the parent-child relationship between the parent visual, which is the owner of the VisualCollection, and the child visual.

Si necesita un control de bajo nivel sobre la implementación de almacenamiento subyacente de objetos visuales secundarios, considere la posibilidad AddVisualChild de RemoveVisualChild usar los métodos y.If you need greater low-level control over the underlying storage implementation of visual child objects, consider using the AddVisualChild and RemoveVisualChild methods. Cuando se usan estos métodos, se define su propia implementación de almacenamiento y no se usa VisualCollection.When you use these methods, you define your own storage implementation, and do not use VisualCollection.

Se aplica a