Ultimate Page Control Suite™ Win32 | Delphi™ | C++Builder™

TOwnedCollection

TADVANCE_PIDCollection

TADVANCE_AuxTools_Collection

TADVANCE_PageGroup_Collection

TADVANCE_ToolCollection__Prot

TADVANCE_MasterTools_Collection

TADVANCE_PagedTools_Collection

TADVANCE_PIDCollections are a managed container of TADVANCE_PIDItems, which are distinguished by a unique, persistent PID identification integer that endures across application sessions. This automatically assigned, read-only integer is the equivalent of a formal name, in that it can be used to permanently identify each PIDItem. As conventional collections lack this capacity, TADVANCE_PIDCollection can be subclassed to deploy TADVANCE_PIDItems which are automatically and permanently identified.

constructor Create_InitPID(AOwner: TPersistent; ItemClass: TCollectionItemClass); virtual;

__fastcall TADVANCE_PIDCollection(Classes::TPersistent* AOwner, TMetaClass* ItemClass);
inline __fastcall TADVANCE_AuxTools_Collection(Classes::TPersistent* AOwner, TMetaClass* ItemClass) : TADVANCE_PIDCollection(AOwner, ItemClass) { }
inline __fastcall TADVANCE_PageGroup_Collection(Classes::TPersistent* AOwner, TMetaClass* ItemClass) : TADVANCE_PIDCollection(AOwner, ItemClass) { }
__fastcall TADVANCE_ToolCollection__Prot(Classes::TPersistent* AOwner, TMetaClass* ItemClass);
__fastcall TADVANCE_MasterTools_Collection(Classes::TPersistent* AOwner, TMetaClass* ItemClass);
inline __fastcall TADVANCE_PagedTools_Collection(Classes::TPersistent* AOwner, TMetaClass* ItemClass) : TADVANCE_ToolCollection__Prot(AOwner, ItemClass) { }

Constructor. ItemClass must be a descendant of TADVANCE_PIDItem.

DELPHI EXAMPLE

MyPIDCollection : TADVANCE_PIDCollection; MyPIDCollection := TADVANCE_PIDCollection.Create(Self, TADVANCE_PagedTools_Item);

C++ EXAMPLE

TADVANCE_PIDCollection * MyPIDCollection = new TADVANCE_PIDCollection ( this, TADVANCE_PagedTools_Item ) ;

function Move(CurIndex, NewIndex: Integer): Integer;
int __fastcall Move(int CurIndex, int NewIndex);

Moves a ToolButton from CurIndex to NewIndex. Re-draw is automated.

DELPHI EXAMPLE

var MyPagedTools_Item : TADVANCE_PagedTools_Item; MyPagedTools_Item.Move(7, 0);

C++ EXAMPLE

TADVANCE_PagedTools_Item * pMyPagedTools_Item->Move ( 7, 0 ) ;

function PID_GetIndex(APID: Integer): Integer; virtual;
virtual int __fastcall PID_GetIndex(int APID);

Returns the index of an item if Item.PID = APID; -1 is returned if no match is found.

DELPHI EXAMPLE — REFERRING TO PID TO PROCESS ITEM BY INDEX OF ITEM

var IndexOfMyPIDItem, MyPIDCollection : Integer; IndexOfMyPIDItem := MyPIDCollection.PID_GetIndex ( MyPIDReferenceInteger ) ; if ( -1 < IndexOfMyPIDItem ) then Process ( MyPIDCollection.Items[ IndexOfMyPIDItem ].[etc.] ) ;

C++ EXAMPLE — REFERRING TO PID TO PROCESS ITEM BY INDEX OF ITEM

int IndexOfMyPIDItem = MyPIDCollection->PID_GetIndex ( MyPIDReferenceInteger ) ; if ( -1 < IndexOfMyPIDItem ) Process ( MyPIDCollection->Items[ IndexOfMyPIDItem ].[etc.] ) ;

function PID_GetItem(APID: Integer): TADVANCE_PIDItem; virtual;
virtual TADVANCE_PIDItem* __fastcall PID_GetItem(int APID);

Returns a pointer to an item if Item.PID = APID; or nil if no match is found.

DELPHI EXAMPLE — REFERRING TO PID TO PROCESS ITEM

var TempPIDItem : TADVANCE_PIDItem; TempPIDItem := MyPIDCollection.PID_GetItem(MyPIDReferenceInteger);

C++ EXAMPLE — REFERRING TO PID TO PROCESS ITEM

TADVANCE_PIDItem * TempPIDItem = MyPIDCollection->PID_GetItem ( MyPIDReferenceInteger ) ;

function PID_GetUniqueValue: Integer; virtual;
virtual int __fastcall PID_GetUniqueValue(void);

Do not call directly. Used internally in creating TADVANCE_PIDItem descendants.

property GreatestPIDValue : Integer read FGreatestPIDValue;
__property int GreatestPIDValue = {read=FGreatestPIDValue, nodefault};

Read only. Returns the greatest used PID value of the TADVANCE_PIDCollection.

TCollectionItem

TADVANCE_PIDItem

TADVANCE_AuxTools_Item

TADVANCE_PageGroup_Item

TADVANCE_ToolCollectionItem__Prot

TADVANCE_MasterTools_Item

TADVANCE_PagedTools_Item

TADVANCE_PIDItem is distinguished by a Persistent ID (PID) which endures across application sessions and allows you to code permanent PID integer references to a TADVANCE_PIDItem.

property PID : Integer read FPID write SetPID stored True;
__property int PID = {read=FPID, write=SetPID, stored=true, nodefault};

Read-only "Persistent ID". A TADVANCE_PIDItem can be identified by the PID integer across application sessions.