void InsertAt ( int nIndex, ARG_TYPE newElement, int nCount = 1 );
tirar ( CMemoryException );
void InsertAt ( int nStartIndex, CArray * pNewArray );
tirar ( CMemoryException );
Parámetros
nIndex
Un índice de entero que puede ser mayor que el valor devuelto por GetUpperBound.
ARG_TYPE
Especifica el tipo de elementos en la matriz de parámetros de plantilla.
newElement
El elemento para colocarse en esta matriz.
nCount
El número de veces que este elemento debe ser insertada (1 de forma predeterminada).
nStartIndex
Un índice de entero que puede ser mayor que el valor devuelto por GetUpperBound.
pNewArray
Otra matriz que contiene los elementos que se agregará a esta matriz.
Observaciones
La primera versión de InsertAt inserta un elemento (o copias múltiples de un elemento) en un índice especificado en una matriz. En el proceso, desplaza (incrementando el índice) el elemento existente de este índice y se desplaza hasta todos los elementos arriba.
La segunda versión inserta todos los elementos de otra colección CArray , comenzando en la posición de nStartIndex.
La función de SetAt , en cambio, sustituye un elemento de la matriz especificada y desplazar los elementos.
Ejemplo
/ / ejemplo de CArray::InsertAt
CArraylt;CPoint, CPoint > ptArray;
ptArray.Add(CPoint(10,20)); / / Elemento 0
ptArray.Add(CPoint(30,40)); / / Elemento 1 (se convertirá en el elemento 2)
ptArray.InsertAt (1, CPoint(50,60)); / / Nuevo elemento 1Visió&n General CArray |nbsp; Miembros de clase | Diagrama de jerarquía
Vea tambié&nnbsp;GetUpperBound, CArray::SetAt, CArray::RemoveAt