System.Contnrs.TComponentList.Remove
Delphi
function Remove(AComponent: TComponent): Integer; inline;
C++
HIDESBASE int __fastcall Remove(System::Classes::TComponent* AComponent);
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| function | public | System.Contnrs.pas System.Contnrs.hpp |
System.Contnrs | TComponentList |
Description
Remove retire le composant spécifié de la liste et, si OwnsObjects a la valeur true, libère le composant.
Appelez la méthode Remove pour supprimer un composant spécifique de la liste quand son indice est inconnu. La valeur renvoyée est l'indice du composant dans le tableau Items avant sa suppression. Si le composant spécifié n'est pas trouvé dans la liste, Remove renvoie –1. Si OwnsObjects a la valeur true, Remove libère le composant en plus de le retirer de la liste.
Après la suppression d'un composant, l'indice de tous les composants est décalé vers le bas et Count est décrémentée. Si un composant apparaît à plusieurs reprises dans la liste, Remove ne supprime que la première occurrence. Par ailleurs, si OwnsObjects a la valeur true, la suppression d'un composant apparaissant plusieurs fois dans la liste entraîne des références vides dans la liste.
Pour utiliser l'indice à la place d'une référence d'objet pour spécifier le composant, appelez la méthode Delete.
Pour retirer un composant de la liste sans le libérer, appelez la méthode Extract.