AssChain

Cicode Programming Reference > Cicode Function Categories > Super Genie Functions Introduction > AssChain

AssChain

Chains the associations from the current Super Genie to a new Super Genie. Use this function to display a new Super Genie when you already have one displayed. The new Super Genie will inherit the associations of the first Super Genie.

This function provides the lowest level of support for chaining associations from one Super Genie to another. You should call the higher level functions AssChainPage(), AssChainWin(), and AssChainPopUp() - these functions are simpler to use.

Syntax

AssChain(hDest, hSource, nMode)

hDest:

The next Super Genie to display in the window specified here will inherit the associations of the current Super Genie - enter the window number, or:

-3: for the current window when the page is changed. The page can be changed by using the Page Cicode functions like PageDisplay, PageGoto, etc.
-2: for the next new window or page displayed.

hSource:

The number of the window containing the source Super Genie (that is the Super Genie from which the associations will be inherited).

nMode:

The mode of the association. Set to 0.

Return Value

0 (zero) if successful, otherwise an error is returned.

Related Functions

Ass, AssMetadata, AssMetadataPage, AssMetadataPopup, AssMetadataWin, AssChainPage, AssChainPopUp, AssChainWin, AssChainWinFree, AssGetProperty, AssGetScale, AssInfo, AssInfoEx, AssPage, AssPopUp, AssScaleStr, AssTag, AssTitle, AssVarTags, AssWin

Example

// Copy associations from the current Super Genie to !NewGenie

AssChain(WinNumber(), WinNumber(), 0);

PageDisplay("!NewGenie");