System.Contnrs.TComponentList.Remove
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.