Technical Reference Manual - InduSoft

Overview of VBScript
'This procedure is executed just once when the graphic module is started
Sub Graphics_OnStart()
MsgBox("Welcome to the system!")
End Sub
'This procedure is executed continuously while the graphic module is running
Sub Graphics_WhileRunning()
If $UserName = "Guest" Then
$MyFlag = 0
End If
End Sub
'This procedure is executed just once when the graphic module is closed
Sub Graphics_OnEnd()
$LogOff()
End Sub
When the Sub-routines Are Executed
On the Server (where InduSoft Web Studio or CEView is running):
• The graphic module is the Viewer task.
• The Graphics_OnStart() sub-routine is executed once on the Server when the Viewer task is launched.
• The Graphics_WhileRunning() sub-routine keeps being executed on the Server while the Viewer task is
running. The Graphics_OnEnd() sub-routine is executed once on the Server when the Viewer task is shut
down.
On the Thin Client or Secure Viewer:
• The graphic module is the ISSymbol control.
• The Graphics_OnStart() sub-routine is executed once on the Thin Client station after logging in
successfully.
• The Graphics_WhileRunning() sub-routine keeps being executed on the Thin Client station while the
ISSymbol control is hosted by the Web Browser.
• The Graphics_OnEnd() sub-routine is executed once on the Thin Client station when the Web Browser is
shut down (or when the ISSymbol control is no longer hosted by the Web Browser).
The execution of the Graphic Script sub-routines on the Server is completely independent of the execution on
the Thin Client and Secure Viewer stations.
Calling Graphics Script Procedures in Other VBScript Interfaces
The three predefined sub-routines are strictly local to the Graphic Script interface and are executed only on
the events described above. Other procedures defined in the interface, however — under the 'Procedures
with local scope heading — may be called in any other Screen Script or Command animation. The
procedures are called by using the syntax Graphics.procedure_name.
Taking the function MyNewProcedure that was declared in the example above, you could place a Button
object on your project screen and then apply a Command animation to it with the following line:
$NewTag = Graphics.MyNewProcedure($OldTag)
SCREEN SCRIPT
To edit the screen script for a project screen, do one of the following:
• On the Graphics tab of the ribbon, in the Screen group, click Script; or
InduSoft Web Studio Page 765