System.Contnrs.TComponentList.Remove

Übergeordnet: TComponentList

Delphi

function Remove(AComponent: TComponent): Integer; inline;

C++

HIDESBASE int __fastcall Remove(System::Classes::TComponent* AComponent);

Eigenschaften

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

Beschreibung

Entfernt eine bestimmte Komponente aus der Liste und gibt sie – falls OwnsObjects true ist – frei.

Mit Remove können Sie eine bestimmte Komponente aus der Liste entfernen, wenn ihr Index nicht bekannt ist. Die Methode gibt nach der Operation die Position des entfernten Elements zurück. Wird die angegebene Komponente nicht gefunden, gibt Remove –1 zurück. Wenn die Eigenschaft OwnsObjects den Wert true hat, wird die Komponente zusätzlich aus dem Speicher freigegeben.

Nach dem Entfernen werden die nachfolgenden Listenelemente um eine Position nach vorne verschoben, und die Eigenschaft Count wird dekrementiert. Ist die angegebene Komponente mehrmals vorhanden, wird nur die erste Instanz entfernt. Wenn OwnsObjects den Wert true hat, treten somit leere Werte weiter hinten in der Liste auf.

Um eine Komponente anhand ihrer Indexposition zu entfernen (anstatt die Objektreferenz anzugeben), verwenden Sie die Methode Delete.

Mit der Methode Extract können Sie eine Komponente entfernen, ohne dass sie freigegeben wird.