TObjectList Class

This page is intended as a supplement to the official documentation on Delphi programming. CodeGear is in the process of putting the Delphi documentation on the Web. Once they have done so, this page will link to the relevant page in the official documentation.

This article is a stub.
Please help enhance the Delphi Programming Wiki by expanding it.

see the VCL Documentation Guidelines for an overview on doc pages

Unit[]

Contnrs Unit

Hierarchy[]

System.TObject < Classes.TList

Description[]

TObjectList expands Tlist by adding the option to take ownership for the Tobject items added to the list through the use of the "OwnsObjects" property. Setting "OwnsObjects" to true will allow the object list to free the memory for each item in the list when the Tobjectlist is freed or removed from the list. Basic methods from Tlist such as add, delete, rearrange, locate, access, and sort remain accessible.

Technical Comments[]

(Known issues / Documentation clarifications / Things to be aware of)

Examples[]

Procedure OwnedObjectDemo;
Var 
  MyObject: TObject;
  MyList: TObjectlist; 
Begin
  MyObject := TObject.Create;
  MyList := TObjectList.Create(True); // OwnsObjects is True.OwnsObjects by default is true so just MyList := TObjectList.Create; would be enough here.
  MyList.Add(MyObject);
  //operating code....
  MyList.Free; //MyObject is also freed since the TObjectList was created with the OwnsObjects property set to true. 
End;

(Please provide links to articles/source code that show how to use this item.)

User Comments/Tips[]

(Please leave your name with your comment.)