System.Contnrs.TObjectList.Insert

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

procedure Insert(Index: Integer; AObject: TObject); inline;

C++

HIDESBASE void __fastcall Insert(int Index, System::TObject* AObject);

Properties

Type Visibility Source Unit Parent
procedure
function
public
System.Contnrs.pas
System.Contnrs.hpp
System.Contnrs TObjectList

Description

Adds an object to the list at a specified position.

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.

See Also