CObArray::InsertAt

项目
03/01/2013

插入元素(或在其他元素中的所有元素数组)在指定的索引。

void InsertAt(
   INT_PTR nIndex,
   CObject* newElement,
   INT_PTR nCount = 1 
);
void InsertAt(
   INT_PTR nStartIndex,
   CObArray* pNewArray 
);

参数

nIndex
与该值可能会显着的一个整数索引由 GetUpperBound返回。
newElement
该数组上的 CObject 指针。值 NULLnewElement 允许的。
nCount
应插入此元素的次数(默认为1）。
nStartIndex
与该值可能会显着的一个整数索引由 GetUpperBound返回。
pNewArray
包含组件将添加到该数组中的另一个数组。

备注

InsertAt 插入的第一个版本一个元素(或组件的多个副本)在指定的索引数组中。在处理，则转换(通过添加索引)为现有元素此索引，因此，它将在其上方所有元素。

第二个版本插入另一 CObArray 集合的所有元素，从开始 nStartIndex 位置。

SetAt 功能，相反，替换为指定的数组元素，并且不转换任何元素。

下表显示类似于 CObArray::InsertAt的其他成员函数。

类	成员函数
CByteArray	void InsertAt( INT_PTR nIndex, BYTE newElement, int nCount=1 ); *引发异常(CMemoryException); void InsertAt( INT_PTR** nStartIndex, CByteArray* pNewArray ); *引发异常(CMemoryException);**
CDWordArray	void InsertAt( INT_PTR nIndex, DWORD newElement, int nCount=1 ); *引发异常(CMemoryException); void InsertAt( INT_PTR** nStartIndex, CDWordArray* pNewArray ); *引发异常(CMemoryException);**
CPtrArray	void InsertAt( INT_PTR nIndex, void* newElement, int nCount=1 ); *引发异常(CMemoryException); void InsertAt( INT_PTR** nStartIndex, CPtrArray* pNewArray ); *引发异常(CMemoryException);**
CStringArray	void InsertAt( INT_PTR nIndex, LPCTSTR newElement, int nCount=1 ); *引发异常(CMemoryException); void InsertAt( INT_PTR** nStartIndex, CStringArray* pNewArray ); *引发异常(CMemoryException);**
CUIntArray	void InsertAt( INT_PTR nIndex, UINT newElement, int nCount=1 ); *引发异常(CMemoryException); void InsertAt( INT_PTR** nStartIndex, CUIntArray* pNewArray ); *引发异常(CMemoryException);**
CWordArray	void InsertAt( INT_PTR nIndex, WORD newElement, int nCount=1 ); *引发异常(CMemoryException); void InsertAt( INT_PTR** nStartIndex, CWordArray* pNewArray ); *引发异常(CMemoryException);**

示例

提供用于所有集合示例的列表 CAge 选件类参见 CObList::CObList。

CObArray arr;

arr.Add(new CAge(21)); // Element 0
arr.Add(new CAge(40)); // Element 1 (will become 2).
arr.InsertAt(1, new CAge(30));  // New element 1
#ifdef _DEBUG
   afxDump.SetDepth(1);
   afxDump << _T("InsertAt example: ") << &arr << _T("\n");
#endif

从此过程的结果如下:

InsertAt example: A CObArray with 3 elements

[0] = a CAge at $45C8 21

[1] = a CAge at $4646 30

[2] = a CAge at $4606 40