System.Classes.TStringList.AddObject
Delphi
function AddObject(const S: string; AObject: TObject): Integer; override;
C++
virtual int __fastcall AddObject(const System::UnicodeString S, System::TObject* AObject);
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| function | public | System.Classes.pas System.Classes.hpp |
System.Classes | TStringList |
Description
Insère une chaîne dans la liste, puis associe un objet à la chaîne.
Appelez AddObject pour ajouter une chaîne et son objet associé à la liste. AddObject renvoie l'index de la nouvelle chaîne et du nouvel objet.
Remarque : Si la propriété OwnsObjects est définie sur False, l'objet TStringList ne possède pas les objets ajoutés de cette manière. Les objets ajoutés à l'objet TStringList existent toujours même si l'instance de TStringList est détruite. Ils doivent être explicitement détruits par l'application. Si vous voulez que les objets soient libérés automatiquement à la destruction de l'objet TStringList, vous devez définir OwnsObjects sur True ou bien utiliser le constructeur Create surchargé qui accepte le paramètre booléen
OwnsObjects, à la création de l'objet TStringList.
Remarque : Dans le cas d'une liste triée, AddObject déclenche une exception EListError si la chaîne S existe déjà dans la liste alors que Duplicates a la valeur dupError. Si Duplicates a la valeur dupIgnore, une tentative d'ajout d'une chaîne dupliquée provoque le renvoi par la méthode AddObject de l'index de l'entrée existante.