System.Contnrs.TComponentList.Extract
Delphi
function Extract(Item: TComponent): TComponent; inline;
C++
HIDESBASE System::Classes::TComponent* __fastcall Extract(System::Classes::TComponent* Item);
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
function | public | System.Contnrs.pas System.Contnrs.hpp |
System.Contnrs | TComponentList |
Beschreibung
Entfernt eine Komponente aus der Liste.
Mit Extract entfernen Sie eine Komponente aus der Liste. Nachdem die Komponente entfernt worden ist, werden alle nachfolgenden Komponente innerhalb der Indexposition verlagert und die Eigenschaft Count wird herabgesetzt.
Extract gibt die aus der Liste entfernte Komponente nicht frei. Darin unterscheidet sich diese Methode von Delete, welche die Methoden freigibt, es sei denn OwnsObjects wurde auf false gesetzt.
Wenn Sie die Referenz auf eine Komponente entfernen wollen, ohne den Eintrag aus dem Array Items zu löschen und die Eigenschaft Count zu ändern, setzen Sie die Eigenschaft Items für Index auf nil (Delphi) bzw. auf NULL (C++).