System.Contnrs.TComponentList.Extract

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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++).

Siehe auch