TStringList.AddObject Method

Adds a string to the list, and associates an object with the string.

Pascal

function AddObject(const S: string; AObject: TObject): Integer; override;

C++

virtual __fastcall int AddObject(const AnsiString S, TObject * AObject);

Description

Call AddObject to add a string and its associated object to the list. AddObject returns the index of the new string and object.

Note: The TStringList object does not own the objects you add this way. Objects added to the TStringList object still exist even if the TStringList instance is destroyed. They must be explicitly destroyed by the application.

Note: For sorted lists, AddObject raises an EListError exception if the string S already appears in the list and Duplicates is set to dupError. If Duplicates is set to dupIgnore, trying to add a duplicate string causes AddObject to return the index of the existing entry.