System.Contnrs.TComponentList.Insert
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 eine Komponente an einer bestimmten Position in die Liste ein.
Mit Insert können Sie eine Komponente an einer bestimmten Position in die Liste einfügen. Dabei werden die nachfolgenden Elemente um eine Position nach hinten verschoben. 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 eine neue Komponente zu ersetzen, ohne das Array zu vergrößern, greifen Sie mit der Eigenschaft Items direkt auf die Liste zu.