TList 对像说明

TList 对像说明

2009年08月16日 下午 10:54

TList 对像说明 ━━━━━━━━━━━━━━━━━━━━━━━━━━ 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替代。