Associates up to eight variable tags or equipment.item tag references with a Super Genie and displays the Super Genie in a popup window. Partial tag names or equipment.item tag references can also be used. 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 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 code 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
Published June 2018