privatevoid InsertAt ( Int nIndex, ARG_TYPE NewElement, Int nCount = 1 );
werfen ( CMemoryException );
privatevoid InsertAt ( Int nStartIndex, CArray * pNewArray );
werfen ( CMemoryException );
Parameter
nIndex
Einen Ganzzahlenindex, der größer als der Wert von GetUpperBound zurückgegeben werden kann.
ARG_TYPE
Die Angabe von Elementen in diesem Array Vorlagenparameter.
newElement
Das Element in diesem Array platziert werden.
nCount
Die Anzahl der Zeiten, die dieses Element sollten eingefügt (Standard: 1).
nStartIndex
Einen Ganzzahlenindex, der größer als der Wert von GetUpperBound zurückgegeben werden kann.
pNewArray
Ein weiteres Array, das mit Elementen in diesem Array hinzugefügt werden.
Bemerkungen
Die erste Version von InsertAt fügt ein Element (oder mehrere Kopien eines Elements) an einem angegebenen Index in ein Array. Dabei verschiebt es sich (durch das Inkrementieren des Indexes) das vorhandene Element am Index, und es verschiebt alle Elemente darüber.
Die zweite Version fügt alle Elemente aus einem anderen CArray -Auflistung, beginnend an der Position nStartIndex.
Die Funktion SetAt demgegenüber ersetzt eine angegebene Arrayelement und wird keine Elemente verschieben.
Beispiel
/ / Beispiel für CArray::InsertAt
CArraylt;CPoint, CPoint > PtArray;
ptArray.Add(CPoint(10,20)); / / Element 0
ptArray.Add(CPoint(30,40)); / / Element 1 (wird zum Element 2)
ptArray.InsertAt (1, CPoint(50,60)); / / Neues Element 1CArray Übersicht | Member der Klasse | Hierarchiediagramm
Siehe auch&Nbsp;GetUpperBound, CArray::SetAt, CArray::RemoveAt