Technical Reference Manual - InduSoft

Appendix: Built-in Scripting Language
Open
Open is a built-in scripting function that opens a project screen.
Function Group Execution Windows Embedded Thin Client
Open Screen Asynchronous Supported Supported Supported
Syntax
Open(strScreen{ | ,optNumX1{ | ,optNumY1,optNumX2,optNumY2,optNumResizeFlag{ | ,optNumID{ |
,optStrMnemonicList } } } })
strScreen
optNumX1
optNumY1
optNumX2
optNumY2
The name of the screen (not including the .scr extension) to be opened.
Note: Some Web servers are case-sensitive. If you plan to deploy your project
as a Web application, then you should use only lowercase letters for the screen
name.
The coordinates, in pixels, for the top-left (X1,Y1) and bottom-right (X2,Y2) corners of the screen.
These are optional parameters. If no values are specified, then the default screen size and
location are used. For more information, see Screen Attributes.
Please note the following special circumstances:
• You can open the screen at the mouse's current position by using Open( "screen", 1 ), or
Open( "screen", 1, −1, −1, −1, … ) if the parameters at the end are needed.
• If optNumX1 equals optNumX2 and optNumY1 equals optNumY2, then the default screen
size is used but the screen is centered at (X1,Y1).
• If optNumX2 is less than optNumX1 and/or optNumY2 is less than optNumY1, or if all four
parameters are set to −1, then the parameters are ignored and the default screen size and
location are used.
optNumResizeFlag
Specifies whether objects in the screen will be resized when the screen is opened:
Value
Description
optNumID
0 Screen objects will not be resized.
1 Screen objects will be automatically resized to fit the new dimensions
of the screen, as specified by the coordinates described above. The
resizing is done at the moment the screen is opened, so if the user
changes the screen size after the screen is opened, then the objects
will not be resized again.
This parameter is required if all four coordinates are specified.
An ID or instance number to be assigned to the screen, because you can open multiple
instances of the same screen file. (This ID is required when a screen is closed using the Close
function.)
This is an optional parameter. If no value is specified, then the default ID is 0.
optStrMnemonicList
Page 580
InduSoft Web Studio