Technical Reference Manual - InduSoft

Appendix: Built-in Scripting Language
Value Command Description
9 SW_RESTORE Activates and displays the specified window.
If the window is minimized or maximized,
then it is restored to its original size and
position.
You should use this command when
restoring a minimized window.
This is an optional parameter. If no value is specified, then the default command is SW_RESTORE.
optNumTimeout
The timeout period (in milliseconds) for the function to be successfully executed. If, for whatever
reason, the function is not executed in this period, then it is aborted.
This is an optional parameter. If no value is specified, then the default timeout is five seconds
(or 5000 milliseconds).
Returned value
This function will return one of the following values:
Value
Description
0 ERROR: The specified application window was not activated or otherwise did
not respond within the timeout period.
1 SUCCESS: The specified application window was successfully activated.
Notes
AppActivate is similar to the function ShowWindow in the Microsoft Windows API, and it allows many of the
same options. For more information, please refer to the Windows API documentation.
Examples
Show the Microsoft Word document named test.doc:
AppActivate( "test.doc — Microsoft Word", 5 )
AppIsRunning
AppIsRunning is a built-in scripting function that verifies another application window is open and running.
Function Group Execution Windows Embedded Thin Client
AppIsRunning Module Activity Synchronous Supported Supported Supported
Syntax
AppIsRunning(strAppTitle{ | ,optNumTimeout })
strAppTitle
The full title (as shown in the title bar) of the application window.
optNumTimeout
The timeout period (in milliseconds) for the function to be successfully executed. If, for whatever
reason, the function is not executed in this period, then it is aborted.
This is an optional parameter. If no value is specified, then the default timeout is five seconds
(or 5000 milliseconds).
Returned value
This function will return one of the following values:
InduSoft Web Studio Page 597