AssPopUp
Associates up to eight variable tags with a Super Genie and displays the Super Genie in a popup 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 the Ass() function or the AssTag() function eight times, and then calling the WinNewAt() function to create a window at the position of the mouse. The AssPopUp() function is a quick way of associating eight Super Genie variables and displaying the Super Genie in a new window at the same time.
If you want to associate more than eight tags with the Super Genie, you need to call the AssVarTags(), AssTag(), or Ass() function to create the associations before you call this function.
Note: This function helps to prevent the Super Genie from being opened more than once (at the same time). However, the same Super Genie with different associations can be opened.
Syntax
AssPopUp(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 8 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 have to enter a blank ("") for sTag2.
The variable tags that you specify here needs 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, AssPage, AssScaleStr, AssTag, AssTitle, AssVarTags, AssWin
Example
// Associate 3 tags with the Super Genie then display it
AssPopUp("!MyGenie", "PV123", "OP123", "SP123");
See Also