Compartir a través de


VisualCollection.Insert(Int32, Visual) Método

Definición

Inserta un elemento en VisualCollection en el índice especificado.

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
Public Sub Insert (index As Integer, visual As Visual)

Parámetros

index
Int32

Índice de base cero donde se va a insertar el valor.

visual
Visual

Objeto Visual que se va a insertar en VisualCollection.

Excepciones

index es menor que cero o mayor que Count.

Comentarios

Si Count ya es Capacityigual a , la capacidad de se incrementa antes de VisualCollection insertar la nueva Visual . Si index es igual a Count, visual se agrega al final de VisualCollection. Los objetos visuales existentes que sean iguales o mayores que index se desplazan para dar cabida al nuevo Visualy se actualizan sus valores de índice.

El Insert 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, considere la posibilidad de usar los AddVisualChild métodos y RemoveVisualChild . Cuando se usan estos métodos, se define su propia implementación de almacenamiento y no se usa VisualCollection.

Se aplica a