Compartir a través de


CArray::InsertAt

La primera versión de InsertAt inserta un elemento (o varias copias de un elemento) en un índice especificado en una matriz.

void InsertAt( 
   INT_PTR nIndex, 
   ARG_TYPE newElement, 
   INT_PTR nCount = 1  
); 
void InsertAt( 
   INT_PTR nStartIndex, 
   CArray* pNewArray  
);

Parámetros

  • nIndex
    un índice entero que puede ser mayor que el valor devuelto por GetUpperBound.

  • ARG_TYPE
    Parámetro de plantilla que especifica el tipo de elementos en esta matriz.

  • newElement
    El elemento que se va a colocar en esta matriz.

  • nCount
    El número de veces que este elemento debe insertarse (el valor predeterminado de 1).

  • nStartIndex
    un índice entero que puede ser mayor que el valor devuelto por GetUpperBound.

  • pNewArray
    Otra matriz que contiene los elementos que se van a esta matriz.

Comentarios

En el proceso, se desplaza hacia arriba (aumentando el índice) del elemento existente en este índice, y se desplaza sobre todos los elementos sobre ella.

La segunda versión inserta todos los elementos de otra colección de CArray , desde la posición de nStartIndex .

La función de SetAt , en cambio, reemplazar un elemento de matriz especificado y no se mueve ningún elemento.

Ejemplo

// example for CArray::InsertAt

CArray<CPoint,CPoint> ptArray;

ptArray.Add(CPoint(10,20));   // Element 0
ptArray.Add(CPoint(30,40));   // Element 1 (will become element 2)
ptArray.InsertAt(1, CPoint(50,60));   // New element 1      

Requisitos

encabezado: afxtempl.h

Vea también

Referencia

CArray Class

Gráfico de jerarquías

CArray::GetUpperBound

CArray::SetAt

CArray::RemoveAt