API:System.Contnrs.TComponentList.Insert

Übergeordnet: TComponentList

Delphi

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

C++

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

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
procedure function	public	System.Contnrs.pas System.Contnrs.hpp	System.Contnrs	TComponentList

Beschreibung

Fügt ein Objekt an der angegebenen Position in der Liste ein.

System.Contnrs.TComponentList.Insert erbt von System.Contnrs.TObjectList.Insert. Der folgende Inhalt bezieht sich auf System.Contnrs.TObjectList.Insert.

Fügt ein Objekt an der angegebenen Position in der Liste ein.

Mit Insert können Sie an einer beliebigen Position ein Objekt in die Liste einfügen, wobei das Element, das zuvor die Position besetzte, und alle darauffolgenden Elemente um eine Position nach vorne verschoben werden. Insert inkrementiert den Wert der Eigenschaft Count und weist bei Bedarf Speicher zu, indem der Wert von Capacity entsprechend erhöht wird.

Der Parameter Index besitzt als Basis den Wert 0, die erste Position der Liste hat somit den Index 0.

Um ein Element mit einem nil- (Delphi) bzw. NULL- (C++) Wert durch ein neues Objekt zu ersetzen, ohne das Array zu vergrößern, greifen Sie mit der Eigenschaft Items direkt auf die Liste zu.