System.Contnrs.TComponentList.Insert

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

procedure Insert(Index: Integer; AComponent: TComponent); inline;

C++

HIDESBASE void __fastcall Insert(int Index, System::Classes::TComponent* AComponent);

Properties

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

Description

Adds a component to the list at a specified position.

Call Insert to add a component 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 component without growing the array, set the Items property directly.

See Also