AssMetadata
This non-blocking function performs Super Genie associations using the "Name" and "Value" fields defined on the Object Properties - Metadata tab, and matches it to the 'Name' field in the page associations table. While performing associations any additional metadata entries are ignored.
Syntax
AssMetadata(hWin [, nAn])
hWin:
The associations will be created for the next Super Genie to display in the window specified. Enter the window number or
nAN:
An animation number that uniquely identifies an object. This object contains the list of metadata definitions that will be used to perform the association operations.This parameter is optional with -2 being the default value. When -2 is specified, it is the same as using the function KeyGetSursor() which returns the animation number of the current active command cursor. Refer to KeyGetCursor() for usage and behavior.
|
UNINTENDED EQUIPMENT OPERATION If called after other cicode functions in a command expression field, retrieve the animation number first, then pass it through the nAN parameter. Failure to follow these instructions can result in death, serious injury, or equipment damage. |
Return Value
0 (zero) if successful, otherwise an error is returned.
Example
/* Example of calling AssMetadata after other cicode functions */
An = KeyGetCursor();
SomeVal = TagRead(“SomeTag”); // do additional work
AssMetadata(-2, An);
PageOpen(“!TestSG”);
Related Functions
Ass, AssChain, AssMetadataPage, AssMetadataPopup, AssMetadataWin, AssChainPage, AssChainPopUp, AssChainWin, AssChainWinFree, AssGetProperty, AssGetScale, AssInfo, AssInfoEx, AssPage, AssPopUp, AssScaleStr, AssTag, AssTitle, AssVarTags, AssWin
See Also