TCollection

2012/6/13 11:40:00  请友读忠(更多)  E界MRP开发下载网  246阅

tcollection 是tcollectionitenm对象的一个容器。

类关系tobject→tpersistent

　　 每一个tcollection都拥有一组tcollectionitem对象。
　　 在其items属性数组中，tccllection保存集合项目的一个下标。* 属性包含了集合的项目数量。使用add和clear方法可以向集合中加入项目和从集合中删除项目。
　　 从tcollection继承的对象能够包含从tcollectionitem继承的对象。例如，一个tdbgridcolumns对象包含tcolumn对象，这两个类被tdbgrid对象用于表示网格。下表列出了每一个tcollection对象的子类与相应的tcollectionltem对象的子类以及使用控制组件。其中，tqurytableproducer和twehdispetcher使用的控件继承自twincontril对象。

tcollection子类 tcollectionitem子类 控件组件

tcheckconstraints tcheckconstraint 使用tfield对象的控件
tcookiecollection tcookie http响应对象
tcoolb*s tcoolb* tcoolbar
tdbgridcolumns tcolumn tdbgrid
tdependencies tdependency tservice
t***dims t***dim tdecisiongrid
tfielddefs tfielddef tdatsset
theadersections theadersection theadercontrol
tindexdefs tindexdef ttable
thtmltablecolumns thtmltablecolumn tquerytableproducer
tlistcolumns tlistcolumn tlistview
tsuatuspanels tsuatuspanel tstatusbar
twebactionitems twebactionitem twebdispatcher

　　 使用tcollection和tcollectionitem子类的控件，都有一个拥有一个集合5的公开属性（例如，tstatusbar的panels属性拥有一个tstatuspanels)。一个标准的属性编辑器，从种属上说被认为是集合编辑器，它被授引自object inspector，以编辑集合中的项目。

属性列表
* 返回集合中的项目数量
itemclass 表示集合项目有种类
items 提供对集合中项目的变址访问

方法列表
“tcollection 删除集合及其内的每一项目
add 创建一新对象实例并加 入到items属性数组中
assign 将另一集合有内容复制到执行该方法的对象中
bcgin* 使屏幕更新暂停
clear 从集合中删除所有项目
end* 使屏幕能够重新进行更新
finditemid 返回id参数指定的项目
* 创建tcollectionitem对象并加入到items属性数组中
tcollection 创建并初始化一个集合

属性
tcollection::*
　　 用于返回集合中的项目数量。
　 __property int * = {read=get*,nodefanlt};
　　 *属性包含了items属性数组中的项目数量。因为items属性数组的下标从0开始，因此，*属性数值总是比items属性数组最后一个成员的下标大1。

tcollection::itemclass
　　 表示集合项目的类。
　 __property int * = {read =getxount,nodefauit};
　　 itemclass返回属于集合的项目的类（继承自tcolliectionitem对象）。例如，在tcollection对象theadersections子类有一个实例中，ietmclass属性返回theadersection .

tcollection::items
　　 提供对集合中项目的变址访问。
　 __property tcollectionitem*irems{int index}={read =getitem,write=setitem};
　　 使用items属性可以访问集合中的单个项目。index参数的数值对应于tcollectionitem对象的index属性。它表示项目 在集合中有位置。

方法
tcollection::“tcollection
　　 删除集合及其内的每一个项目 。
　　 __fastcall virtual“tcollection(void);
　　 不要直接调用“tcollection 用*会自动调用“tcollection
　　 “tcollection调用clear方法,释放在items属性数组中每一个被子引用的项目，然后删除集合本身。

tcollection::add

　　 创建一个新的tcollectionitem对象实例，并将其加入到items属性数组中。
　 tcollectionitem* __fasteall add(void);
　　 调用add可以在集合中创建一个项目。新项目被放置在items属性数组的结尾处。add返回新集合项目。

tcollection::assign
　　 将另一个集合的内容复制到执行该方法的对象。
　 virtual void __fastcall assign (tpersistemt*source);
　　 使用assign,可以将一个tcollection对象实例的内容复制至另一个tcollection对象。assign方法删除目的集合（即执行该方法的对象）中的所有项目，然后加入由source参数指定的集合的items属性数组中的每一个项目的复制。

tcollection::begin*
　　 使屏幕更新暂停。
　 void　__fastcall begin*(void);
　　 begin*使屏幕更新暂停，直至调用了end*方法。使用begin*可以加速进行处理，并且当向一个集合中加入项目或从一个集合中删除项目时，可以避免闪烁。

tcollection::end*
　　 从集合中删除所有项目。
　 void __fastcall ciear(void);
　　 ciear清空items属性数组并删除每一个tcollectionitem对象。

tcollection::end*
　　 使屏幕能够重新进行更新。
　 void __fastcall end*(void);
　　 使用end*,可以使以begin*方法关闭的屏幕能够重新进行更新。

tcollection::finditemid
　　 返回id参数指定的项目。
　 tcollectionitem* __fastcall finditemid(int id)；
　　 finditemid方法返回集合中的项目，该项目的id属性被作为一个参数传递。如果没有id参数指定的项目，则finditemid返回null.

tcollection::*
　　 创建一个新的tcollectionitem对象实例，并将其加入到items属性数组中。
　 tcollectionitem* __fastcall *(int index);
　　 调用 *，可以在集合中的一个指定位置处加入一个新项目。在items属性数组中已经存在的从指定位置开始的项目将向上移动。*返回新集合项目。

tcolletion::tcollection
　　 创建并初始化一个集合。
　 __fastcall tcollection (sysem::tmetaciass*itemciass);
　　 不要直接调用 tcollection。用new会返回新集合的一个间接引用。
　　 tcollection方法取一个tcollectionitem子类名作为一个参数。该参数确定了由add方法创建的项目的类。