Technical Reference Manual - InduSoft

Appendix: Built-in Scripting Language
SetAppPath
Sets the new file path for the project folder. After this function is executed, IWS will look for all of the project
files (i.e.,screens, alarms, trends, database, events) in this folder.
Function Group Execution Windows Embedded Thin Client
SetAppPath Module Activity Synchronous Supported Not supported Executed on Server
Syntax
SetAppPath(strPath)
strPath
The file path.
Returned value
0 Failed to set path.
1 Succeeded in setting path
Examples
Tag Name
Expression
SetAppPath( "C:\Studio\" )
Note: If the computer is on a network, you can use the //IP address or host name/Path syntax
to define a location on another node of the network.
SetViewerInFocus
SetViewerInFocus is a built-in scripting function that moves the project viewer in front of all other open
windows and then maximizes it to fill the display.
Function Group Execution Windows Embedded Thin Client
SetViewerInFocusModule Activity Synchronous Supported Not Supported Supported
Syntax
SetViewerInFocus()
There are no parameters.
Returned value
This function does not return any value.
Notes
Beginning with Windows XP, system security features prevent program windows from moving themselves
in front of others without user input. As such, when you call this function, the Viewer program will request
the user's attention by blinking in the Windows taskbar. (Some anti-virus software may also flag this as
suspicious behavior.) Only when the user selects the program will the program window move to the front.
To work around this, you must call SetViewerInFocus at least once in your project's Startup Script. Allow
twenty seconds more for your project to finish starting up, and then after that, any additional calls of this
function should work normally.
InduSoft Web Studio Page 619