TList包含对象指针列表。
类关系 TObject
Tlist用于存储和维护对象列表。TList引入属隆和方法以执行以下操作：
(1)在列表中增加或删除对象。
(2)在列表中重排对象。
(3)在列表中定位和获得对象。
(4)在列表中对对象进行排序。
属性列表
Capacity 标识TList对象维护的指针数组的大小。
Count 表明在列表中使用的项的数量。
Items 列出对象的引用。
List 标识组成Items的指针数组。
方法列表
~TList 删除与TList对象有关的内存。
Add 在列表的末尾插入有关的内存。
Clear 从列表中删除所有项。
Delete 删除Index参数标识的项。
Error 产生EListError异常。
Exchange 交换Items数组中两项的位置。
Expand 增加列表的Capacity。
First 返回Items[0]。
IndexOf 返回Items数组中一指针的索引。
Insert 增加一对象至Items数组中。
Last 返回Items[Count-1]。
Move 在Items数组中改变某一项的位置。
Pack 从Items数组中删除所有的零项。
Remove 从Items数组中删除Items参数的第一个引用。
Sort 在列表中执行QuickSort。
TList 创建一个新的TList对象。
详细说明
属性
TList::Capacity
__property int Capacity = {read=FCapacity,write=SetCapacity,nodefault};
标识TList对象维护的指针数组的大小。
设置Capacity为列表将要包含的指旬数。当当设置Capacity属性时，如果没有足够的内存扩展列表为它的新的大小，将产生EOutOfMemory异常。
在没有重新分配内存情况下，读取Capacity可得到列表能包含的对象数。注意不要混淆Capacity和Count属性；Count属性为列表中使用的项的数量。Capacity值总是大于或等于Count值。当Capacity大于Count，通过设定Capacity至Count可以回收未使用的内存。当添加一对象至列表，而此列表已被填充到Capacity时，Capacity属性自动增加。在增加对象之前设置Capacity能减少内存重分配的数量，因此提高了执行效果。例如：
List->Clear();
List->Capacity = Count;
for(int i=0;i<Count;i++) List->add(...);
在for循环之前分配Capacity保证在随后的每一Add操作不重新分配列表。在调用Add时避免重新分配可以提高执行效果并且保证Add操作不产生异常。
TList:;Count
__property int Count = {read=FCount,write=SetCount,nodefault};
表明在列表中使用的项的数量。
读取Count可以确定Items数组中项的数量。增加Count的大小将在Items数组的末尾增加必要的零指针的数量；减小Count的大小将从Items数组的末尾删除必要的零指针的数量。
注意：Count并不总等同于列表中引用的对象的数量。在Items数组中，某些项将包含零指针。如果要删除零指针并且设置Count为对象引用的项数，则可以调用Pack方法。
TList::Items
__property void* Items[int Index] = {read=Get,write=Put};
列出对象的引用。
使用Items可以获得数组中指定对象的指针。Index参数标识对象的索引；第一个对象的索引值为0，第二个对象的索引值为1,以此类推。设置Items可以在指定位置改变引用。使用带有Count属性的Items可以遍历列表中的所有对象。
应该注意的是，并不是Items数组中所有的项都需包含对象的索引。有些项可能是零指针。如果要删除零掼针并且减小Items数组的大小至对象的数量，可以调用Pack方法。
TList::List
typedef void* TPointerLIst[134217727];
typedef TPointerLIst* PPointerList;
__property PPointerList List = {read=FList};
标识组成Items的指针数组。
使用List直接获得Items数组。
TList::~TList
__fastcall virtual~TList(void);
删除与TList对象有关的内存。
在应用中不要直接调用~TList。用delete替代。
~TList释放存储项列表的内存。注意，~TList并不释放指向列表元素的内存。
TList::Add
int __fastcall Ad(void* Item);
在列表的末尾插入新项，可以调用Add方法。Add方法返回值为新项的索引值；列表中第一项的索引值为0
如果Items数组使用完列表对象Capacity，则Add方法分配更多的内存。Add增加Count值以反映新指针的增加。注意：即使Items数组包含零指针，Add方法总是在Items数组的末尾插入Items指针。
TList::Clear
DYNAMIC void __fastcall Clear(void);
从列表中删除所有项。
如果要清空Items数组并且设置Count为0，可以调用Clear方法。Clear方法同时释放用于存储Items数组的内存并且设置Capacity为0。
TList::Delete
void __fastcall Delete(int Index);
删除Index参数标识的项。
如果要从列表指定位置删除项，可以调用Delete方法。索引从零开始，因此第一项的索引值为0,第二项的索引值为1，以此类推。调用Delete方法向前移动删除项之后的所有英并减小Count。
如果要删除一项的索引但并不从列表中删除该项并且改变Count，可设置Index的Items属性为零。注意Delete并不释放的项相关的内存。如果要释放存储删除项的内存，可设置Capacity属性。
TList::Error
virtual void __fastcall Error(const System::AnsiString Msg,int Data) {Error(__classid(TList),Msg,Data};
产生EListError异常。
当TList对象出现错误时，调用Error产生异常。Error组合Msg参数标识的错误消息和Data参数标识的数据植，然后产生EListError异常。调用Error而不是增加一行程序代码，例如：
throw EListError(MyMsg,iBadValue);
为减少应用程序的代码量。
TList::Exchange
void __fastcall Exchange(int Index1,int Index2);
交换Items数组中两项的位置。
如果要交换台Items数组中位于Index1和Index2的项的位置，可以调用Exchange方法。索引从零开始，因此，列表中第一项的索引值为0，第二项的索引值为1，以此类推。
TList::Expand
TList* __fastcall Expand(void);
增加列表的Capacity。
为了在列表增加新项，可以调用Expand以创建更多的空间。如果没有填充列表至Capacity，Expand一作任何处理。如果Count = Capacity，Expand按如下增加列表的Capacity。如果Capacity值大于8，Expand增加列表的Capacity至16；如果Capacity值大于4，但是小于8，列表的Capacity增加至8，如果Capacity值小于4，列表的Capacity 增加4。
返回值为扩展的列表对象。
TList::First
void* __fastcall First(void);
返回Items[0]。
调用First获得Items数组中的第一个指针。
TList::IndexOf
int __fastcall IndexOf(void* Item);
TList::Inset
void __fastcall Insert(int Index,void* Item);
返回Items数组中一指针的索引。
调用IndexOf获得Items数组中一指针的索引。Item参数标识指针。数组中第一项索引值为0，第二项的索引值为1，以此类推。如果项不在列表中，IndexOf返回-1。如果一指针在列表中出现多次，IndexOf返回第一次出现的索引值。
TList::Last
void* __fastcall(void);
增加一对象至Items数组中；Index参数标识该对象的添加位置。
如果要添加Item至Items数组中，可以调用Insert方法。Index参数为基于0的索引，因此，数组中的第一个位置的索引值为0。Insert在指定位置增加项；改变原先处于此位置的项以及后面的所有项。如果必要，Insert扩充列表的Capacity并且设置Items属性。
TList::Move
void __fastcall Move(int CurIndex,int NewIndex);
返回Items[Count-1]。
如果要在Items数组中得到最后的指针，可以调用Last方法。
TList::Pack
void __fastcall Pack(void);
从Items数组中删除所有的零项。
调用Pack将所有非零项移至Items数组的前面并且减小Count属性为实际使用的项的数量。Pack并不释放存储零指针的内存。为了释放通过Pack方法删除的不使用项所占用的内存，可以设置Capacity属性为Count的新值。
TList::Remove
int __fastcall Remove(void* Item);
从Items数组中删除Item参数的第一个引用。
当不知道指定项的索引时，调用Remove从Items数组中删除指定项。在删除指定项之前，返回该项的索引。在指定项删除之后，该项之后的所有项的索引位置提前并且Count减一。应该注意的是，如果Items数组包含指针的多个复制，仅第一个复制被删除。
TList::Sort
typedef int __fastcall (*TListSortCompare)(void* Item1,void* Item2);
void __fastcall Sort(TListSortCompare Compare);
根据Compare函数的比较，在列表中执行QuickSort。
如果要对Items数组中草药的项进行排序，可以调用Sort方法。Compare为比较函数，该函数表明项是如何进行排序的。如果Item1小于Item2，则Compare返回值为0；如果Item1大于Item2，则Compare返回值大于0；
TList::TList
__fastcall virtual TList(void);
创建一个新的TList对象。
不要直接调用TList。用new替代。
|
