CObArray::InsertAt

void InsertAt ( int nIndex, CObject * newElement, int nCount = 1 );
tirar ( CMemoryException );

void InsertAt ( int nStartIndex, CObArray * pNewArray );
tirar ( CMemoryException );

Parámetros

nIndex

Un índice de entero que puede ser mayor que el valor devuelto por GetUpperBound.

newElement

El puntero de CObject para colocarse en esta matriz. Se permite un newElement de valor NULL.

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 de CObArray , 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.

La siguiente tabla muestra otras funciones miembro que son similares a CObArray::InsertAt.

Clase Función miembro
CByteArray a&nular InsertAt (int nIndex, BYTE newElement, int nCount=1);
nbsp;tirar ( CMemoryException );

anular InsertAt (int nStartIndex, CByteArray * p&NewArray );
nbsp;tirar ( CMemoryException );

CDWordArray a&nular InsertAt (int nIndex, DWORD newElement, int nCount=1);
nbsp;tirar ( CMemoryException );

anular InsertAt (int nStartIndex, CDWordArray * p&NewArray );
nbsp;tirar ( CMemoryException );

CPtrArray a&nular InsertAt (int nIndex, void * newElement, int nCount=1);
nbsp;tirar ( CMemoryException );

anular InsertAt (int nStartIndex, CPtrArray * p&NewArray );
nbsp;tirar ( CMemoryException );

CStringArray a&nular InsertAt (int nIndex, LPCTSTR newElement, int nCount=1);
nbsp;tirar ( CMemoryException );

anular InsertAt (int nStartIndex, CStringArray * p&NewArray );
nbsp;tirar ( CMemoryException );

CUIntArray anular InsertAt (int nIndex, UI&NT newElement, int nCount=1);
nbsp;tirar ( CMemoryException );

anular InsertAt (int nStartIndex, CUIntArray * p&NewArray );
nbsp;tirar ( CMemoryException );

CWordArray a&nular InsertAt (int nIndex, WORD newElement, int nCount=1);
nbsp;tirar ( CMemoryException );

anular InsertAt (int nStartIndex, CWordArray * p&NewArray );
nbsp;tirar ( CMemoryException );


Ejemplo

Consulte CObList::CObList para obtener una lista de los CAge clase utilizada en todos los ejemplos de colección.

/ / ejemplo de CObArray::InsertAt

nbsp;  Matriz de CObArray;
    
    arreglo de discos.Agregar (Nueva jaula (21)); / / Elemento 0
    arreglo de discos.Agregar (Nueva jaula (40)); / / Elemento 1 (se convertirá en 2).
    arreglo de discos.InsertAt (1, Nueva jaula (30));  / / Nuevo elemento 1
# ifdef _DEBUG
    afxDump.SetDepth (1);
    afxDump << "InsertAt ejemplo:" << & matriz << "\n";
# endif

Los resultados de este programa son los siguientes:

I&nsertAt ejemplo: un CObArray con 3 elementos
 nbsp;  [0] = una jaula a 45 ° C 8 21
    [1] = una jaula en $4646 30
    [2] = una jaula en 4606 $ 40

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

Vea tambié&nnbsp;CObArray::SetAt, CObArray::RemoveAt

Index