AssPage
Associates up to eight variable tags with a Super Genie and displays the Super Genie in the current window. The first variable tag (sTag1) replaces Super Genie substitution string 1. The second variable tag (sTag2) replaces substitution string 2, and so on.
This function has the same effect as calling Ass() or AssTag() eight times, and then calling the PageDisplay() function. The AssPage() function provides a quick way of associating eight Super Genie variables and displaying the Super Genie - at the same time.
If you want to associate more than eight tags with the Super Genie, it is strongly recommended you call the AssVarTags(), AssTag(), or Ass() function to create the associations before you call this function.
Syntax
AssPage(sPage, sTag1, [sTag2..8] )
sPage:
The page name of the Super Genie. If you prefixed your Super Genie page name with an exclamation mark (!), remember to include it here.
sTag1..sTag8:
The first eight physical tags to be associated with the Super Genie. For any given Super Genie, the variable tags will replace the Super Genie substitution strings as follows:
|
Variable tag... |
replaces substitution string... |
|
sTag1 |
1 |
|
sTag2 |
2 |
|
sTag3 |
3 |
|
sTag4 |
4 |
|
sTag5 |
5 |
|
sTag6 |
6 |
|
sTag7 |
7 |
|
sTag8 |
8 |
Because there is a strict correlation between the variable tag numbers and the substitution string numbers, you need to know how your Super Genie substitutions are numbered. For example, if your Super Genie has three unique substitution strings, numbered 1, 3, & 4, you need to enter a blank ("") for sTag2.
The variable tags that you specify here need to be the same data type as that specified by the relevant Super Genie substitution strings. For example, only a digital tag could replace the substitution string ?DIGITAL 4?. If the substitution string does not specify a type (for example, ?5?), you can use any type except STRING.
The name of the tag can be prefixed by the name of the cluster for example, "ClusterName.Tag".
Return Value
0 (zero) if successful, otherwise an error is returned.
Related Functions
Ass, AssChain, AssMetadata, AssMetadataPage, AssMetadataPopup, AssMetadataWin, AssChainPage, AssChainPopUp, AssChainWin, AssChainWinFree, AssGetProperty, AssGetScale, AssInfo, AssInfoEx, AssPopUp, AssScaleStr, AssTag, AssTitle, AssVarTags, AssWin
Example
// Associate 3 tags with the Super Genie then display the Super Genie
AssPage("!MyGenie", "PV123", "OP123", "SP123");
See Also