System.WideStrings.TWideStringList.AddObject

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

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

C++

virtual int __fastcall AddObject(const System::WideString S, System::TObject* AObject);

Properties

Type Visibility Source Unit Parent
function public
System.WideStrings.pas
System.WideStrings.hpp
System.WideStrings TWideStringList

Description

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

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 TWideStringList object does not own the objects you add this way. Objects added to the TWideStringList object still exist even if the TWideStringList 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.

See Also