System.Contnrs.TObjectList.Remove
Delphi
function Remove(AObject: TObject): Integer; overload; inline;
C++
HIDESBASE int __fastcall Remove(System::TObject* AObject)/* overload */;
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
function | public | System.Contnrs.pas System.Contnrs.hpp |
System.Contnrs | TObjectList |
Description
Remove supprime un objet spécifié de la liste et (si OwnsObjects est à true) libère l'objet.
Appelez Remove pour supprimer un objet spécifique de la liste lorsque l'indice est inconnu. La valeur renvoyée est l'indice de l'objet dans le tableau Items avant sa suppression. Si l'objet spécifié n'est pas trouvé dans la liste, Remove renvoie –1. Si OwnsObjects est à true, Remove libère l'objet en plus de le supprimer de la liste.
Après qu'un objet a été supprimé, tous les objets qui suivent sont déplacés et Count est décrémenté. Si un objet apparaît plusieurs fois dans la liste, Remove ne supprime que la première occurrence. Si OwnsObjects est à true, la suppression d'un objet apparaissant plusieurs fois se traduit ultérieurement par des références d'objet vides dans la liste.
Pour utiliser une position indicielle (au lieu d'une référence d'objet) pour spécifier l'objet à supprimer, appelez Delete.
Pour supprimer un objet de la liste sans le libérer, appelez Extract.