VisualCollection.Insert(Int32, Visual) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 -> unitPublic 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.