CArray::InsertAt

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 1

Visió&n General CArray |nbsp; Miembros de clase | Diagrama de jerarquía

Vea tambié&nnbsp;GetUpperBound, CArray::SetAt, CArray::RemoveAt

Index