Ultimate Page Control Suite™ Win32 | Delphi™ | C++Builder™; D.09. TADVANCE_PageGroup

Each PMInterface contains a TADVANCE_PageGroup_Collection of TADVANCE_PageGroup_Items which prescribe how the NavigationWindow™ is to display each PageGroup™.

METHODS

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

Moves a PageGroupItem from CurIndex to NewIndex. Re-draw is automated. Note that order is irrelevant to NavigationWindow processes.

DELPHI EXAMPLE

C++ EXAMPLE

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

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

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

C++ EXAMPLE — REFERRING TO PID TO PROCESS ITEM

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

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

D.09.B. TADVANCE_PageGroup_Item

TCollectionItem

TADVANCE_PIDItem

TADVANCE_AuxTools_Item

TADVANCE_PageGroup_Item

TADVANCE_ToolCollectionItem__Prot

TADVANCE_MasterTools_Item

TADVANCE_PagedTools_Item

TADVANCE_PageGroup_Item wraps a prescription for rendering the PageGroup™ in the Navigationwindow™.

PageGroups™ PROPERTY EDITOR, PROPERTY EDITOR FUNCTIONS

The ellipsis button of the PMInterface.PageGroups property invokes the PageGroups™ property editor.

The PageGroups™ property editor maintains all configurable PageGroup™ properties without leaving the editor. Because of the display rules honored by the NavigationWindow™, item order has no effect on behavior.

FUNCTIONS

ADD appends a new TADVANCE_PageGroup_Item to the PageGroups collection.
Delete destroys the selected TADVANCE_PageGroup_Item, subject to confirmation.
Dec(Index) decrements the index property of the selected PageGroup_Item.
Inc(Index) increments the index property of the selected PageGroup_Item.
Edit assigns editable fields of the selected item to the editing controls. To post work to the item, you must click Post.
Post assigns edited values to the item.

It is not necessary to operate on PageGroup_Items in the Object Inspector, because all of the editable fields are handled by the PageGroups property editor.

Example PageGroup_Item in the Object Inspector. It is not necessary to operate on PageGroup_Items in the Object Inspector, because all of the editable fields are handled by the PageGroups property editor.

PROPERTIES

property FontColor : TColor read FFontColor write FFontColor;
__property Graphics::TColor FontColor = {read=FFontColor, write=FFontColor, nodefault};

FontColor is applied to the SubtitleCaption and PageNavigationButton captions of the PageGroup™ in the Navigation Window, resulting in color matching across the group.

property Hint : String read FHint write FHint;
__property AnsiString Hint = {read=FHint, write=FHint};

SubtitleCaption.Hint.

property SubtitleCaption : String read FSubtitleCaption write FSubtitleCaption;
__property AnsiString SubtitleCaption = {read=FSubtitleCaption, write=FSubtitleCaption};

The SubtitleCaption is displayed as the heading of the PageGroup™ in the NavigationWindow™.

DELPHI EXAMPLES

C++ EXAMPLES