TCollection

副标题#e#

TCollection 是TCollectionItenm工具的一个容器。

类干系TObject→TPersistent

每一个TCollection都拥有一组TCollectionItem工具。

在其Items属性数组中，TCcllection生存荟萃项目标一个下标。Count 属性包括了荟萃的项目数量。利用Add和Clear要领可以向荟萃中插手项目和从荟萃中删除项目。

从TCollection担任的工具可以或许包括从TCollectionItem担任的工具。譬喻，一个TDBGridColumns工具包括TColumn工具，这两个类被TDBGrid工具用于暗示网格。下表列出了每一个TCollection工具的子类与相应的TCollectionltem工具的子类以及利用节制组件。个中，TQuryTableProducer和TWehDispetcher利用的控件担任自TWinContril工具。

TCollection子类 TCollectionItem子类 控件组件

TCheckConstraints TCheckConstraint 利用Tfield工具的控件

TCookieCollection TCookie HTTP响应工具

TCoolBands TCoolBand TCoolBar

TDBGridColumns TColumn TDBGrid

TDependencies TDependency TService

TDisplayDims TDisplayDim 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，以编辑荟萃中的项目。

属性列表

Count 返回荟萃中的项目数量

ItemClass 暗示荟萃项目有种类

Items 提供对荟萃中项目标变址会见

要领列表

~TCollection 删除荟萃及其内的每一项目

Add 建设一新工具实例并加 入到Items属性数组中

Assign 将另一荟萃有内容复制到执行该要领的工具中

Bcginupdate 使屏幕更新暂停

Clear 从荟萃中删除所有项目

EndUpdate 使屏幕可以或许从头举办更新

FindItemID 返回ID参数指定的项目

Insert 建设TCollectionItem工具并插手到Items属性数组中

TCollection 建设并初始化一个荟萃

属性

TCollection::Count

用于返回荟萃中的项目数量。

__property int Count = {read=getCount,nodefanlt};

Count属性包括了Items属性数组中的项目数量。因为Items属性数组的下标从0开始，因此，Count属性数值老是比Items属性数组最后一个成员的下标大1。

#p#副标题#e#

TCollection::ItemClass

暗示荟萃项目标类。

__property int count = {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 用delete会自动挪用~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::BeginUpdate

使屏幕更新暂停。

void　__fastcall BeginUpdate(void);

BeginUpdate使屏幕更新暂停，直至挪用了EndUpdate要领。利用BeginUpdate可以加快举办处理惩罚，而且当向一个荟萃中插手项目或从一个荟萃中删除项目时，可以制止闪烁。

TCollection::EndUpdate

从荟萃中删除所有项目。

void __fastcall CIear(void);

CIear清空Items属性数组并删除每一个TCollectionItem工具。

TCollection::EndUpdate

使屏幕可以或许从头举办更新。

void __fastcall EndUpdate(void);

利用EndUpdate,可以使以BeginUpdate要领封锁的屏幕可以或许从头举办更新。

TCollection::FindItemID

返回ID参数指定的项目。

TCollectionItem* __fastcall FindItemID(int ID)；

FindItemID要领返回荟萃中的项目，该项目标ID属性被作为一个参数通报。假如没有ID参数指定的项目，则FindItemID返回NULL.

TCollection::Insert

建设一个新的TCollectionItem工具实例，并将其插手到Items属性数组中。

TCollectionItem* __fastcall Insert(int Index);

#p#分页标题#e#

挪用 Insert，可以在荟萃中的一个指定位置处插手一个新项目。在Items属性数组中已经存在的从指定位置开始的项目将向上移动。Insert返回新荟萃项目。

TColletion::TCollection

建设并初始化一个荟萃。

__fastcall TCollection (Sysem::TMetaCIass*ItemCIass);

不要直接挪用 TCollection。用new会返回新荟萃的一个间接引用。

TCollection要领取一个TCollectionItem子类名作为一个参数。该参数确定了由Add要领建设的项目标类。