CArray::InsertAt

InsertAt 第一版插入項目 (或項目的多個複本) 中的指定索引的陣列。

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

參數

  • nIndex
    的值可能大於的整數索引。 GetUpperBound傳回。

  • ARG_TYPE
    指定項目的型別樣板參數在這個中的陣列。

  • newElement
    在陣列中放置項目的項目。

  • nCount
    應該插入項目的次數 (預設值為 1)。

  • nStartIndex
    的值可能大於的整數索引。 GetUpperBound傳回。

  • pNewArray
    包含項目會加入至陣列的另一個陣列。

備註

在處理序中,它會將移位 (索引) 為現有項目,在這個索引,並將其上方的所有項目。

第二種版本中插入另一個 CArray 集合中所有的項目開始, nStartIndex 位置。

SetAt 函式,相較之下,取代指定的陣列元素,且不會將任何項目。

範例

// 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      

需求

Header: afxtempl.h

請參閱

參考

CArray 類別

階層架構圖

CArray::GetUpperBound

CArray::SetAt

CArray::RemoveAt