Dynamically Instantiate a Genie at Runtime
- Last UpdatedJul 13, 2023
- 1 minute read
Use the DspSym Cicode function with a Genie to dynamically display content that is only generated at runtime. DspSym can be used with or without an expression.
At runtime when the page is refreshed or the operator clicks away from the page the instantiated Genie is deleted.
Note: ActiveX objects and controls (such as Process Analyst, Database Exchange Control and
Scheduler) are not supported. If used and the "I want to use this Genie with Cicode
Function DspSym" is selected, then on saving the page the following error message
will be displayed:
Genie cannot be saved.
Genies cannot contain ActiveX controls when configured to be used with the cicode
function DspSym.
You must remove all ActiveX controls to continue.
To save the page, deselect the checkbox or remove or delete the ActiveX controls used
in the Genie.
To edit the properties of the Genie:
-
Open Graphics Builder.
-
Click the Open button on the toolbar, or select Open from File menu.
-
Select the Genie tab.
-
Select the Project and Library in which the Genie is stored.
-
Select the Genie.
-
Click OK.
-
Right click on the page and select Page Properties
-
Select the option "I want to use this Genie with Cicode Function DspSym"
-
Click OK
-
If the Genie or an object within the genie uses substitution '%%' syntax in the expression, replace the substitution with the full expression so it can be used at runtime. If you do not edit the substitution a compile error message may be displayed.
Note: You can define Metadata instead of using the full expression.