RAD Studio VCL Reference
ContentsIndex
PreviousUpNext
TObjectList.Insert Method

Adds an object to the list at a specified position.

Pascal
procedure Insert(Index: Integer; AObject: TObject);
C++
__fastcall Insert(int Index, TObject * AObject);

Call Insert to add an object at a specified position in the list, shifting the item that previously occupied that position (and all subsequent items) up. Insert increments Count and, if necessary, allocates memory by increasing the value of Capacity. 

The Index parameter is zero-based, so the first position in the list has an index of 0. 

To replace a nil (Delphi) or NULL (C++) reference with a new object without growing the array, set the Items property directly. 

 

Copyright(C) 2009 Embarcadero Technologies, Inc. All Rights Reserved.
What do you think about this topic? Send feedback!