Screen Commands
This group of commands are used to perform operations to open the Movicon
Screen windows.
Screen (Page)
The name of the Screen to be opened, printed or closed, is entered in
this edit box (or selected with the '...'
browse button on the right).
The syntax to use when selecting a child project screen is:
ChildProjectName\ScreenName
The syntax to use when selecting a parent project screen from a child
project is:
..\ScreenName
Action
The type of command or action to be executed on the selected Screen
is selected in this property. The options are:
Action |
Description |
Open
Normal (scree change) |
This command consents a Screen window
to be opened in the classic mode which is a window within the
Movicon Main frame. Opening the Screen in this way will automatically
close the previous one opened by unloading it from the
system's RAM if its "Not Destroyable"
option has not been enabled in the 'Screen Style Properties'.
|
Open
Modal (pop-up screen) |
This command consents the opening and
displaying of the Screen as a 'Modal Window' and, therefore, managed
in the same way as a Dialog Box. It will open and display on top
of the Screen window from which it was called. The Modal Screen
is a secondary window which captures all the input from the user
until it is closed.
|
Open
Frame (multi-monitor) |
This command opens and displays a Screen
by opening a new window which is different from the Movicon's
main window. This command can also be used to open screens in
another Monitor that is not the default one to allow you to manage
projects in a Multi-Monitor system.
When using the Open Frame
command to open a screen in another monitor (different from the
one on which the project was started up), you may size the screen
in question by using its "Width" and "Height"
parameters. If the '0' value is set in either one of these
parameters, the screen in question will always be opened within
a window and maximized to the sizes of this second monitor.
|
Open
in other process (Safe Mode) |
This
command allows the opening and displaying of a Screen by executing
another instance. Therefore, a process in a different memory area.
This
is useful if any errors should occur in the main application with
Screens using ActiveX.
However, this
mode will consume multiple resources overall for the Screen acting
as client in 'Safe Mode' and for the one acting as server that
loaded it.
|
Print |
This
command is used to print the selected screen directly by using
the printer set as the operating system's default printer. In
order to obtain more print options, such as the print review and
printer selection window, you will need to use the "PrintSynoptic"
function from the "ScreenCmdTarget" basic interface.
|
Close
and Return Back |
This command closes the selected Screen.
If the Screen has been opened in 'Normal' mode, the current Screen
will be closed and the previously displayed screen loaded. This
happens only when the screen to be closed is the same one displayed
on video screen or when nothing has been specified in the "Close"
command's "Screen" parameter.
|
When
the "Close" command is executed leaving the
"Screen" field empty to return to the previous
screen, it will only work if invoked from a screen object,
such as a Button , a Hot Region, etc., and will not work
for all those resources outside the screen's context,
such as Menus, Accelerators, Basic Scripts, Event Objects,
Alarms, etc. In this case, a message will be generated
in the Historical Log stating "Cannot find the screen": |
|
Execute Synapses |
This command type activates the Synapses
logic contained in the specified Screen. The logic will always
be executed in 'asynchronous' mode.
This command can also be executed from Basic
Script in 'synchronous' or 'asynchronous' mode.
|
Open Next (open
as normal next ID screen) |
This command
opens the next screen to the one already opened according to a
map established by the value set in the ID property of each screen.
The next screen will open in "Normal" mode. For
further information on how to use this command, please see "Screen
Change commands based on Screen IDs".
|
Open Prev. (open
as normal prev. ID screen) |
This command
opens the screen previous to the one already open according to
a map established by the value set in the ID property of each
screen. The previous screen will open in "Normal" mode.
For further information on how to use this command, please
see "Screen
Change commands based on Screen IDs".
|
Capture and
Print
|
This
command captures the desired screen and sends it to the printer
predefined in the operating system being used. This screen
can be either be the one already opened or another one. When
the screen to be printed is not the one currently opened, its
name must be specified in the "Screen"
parameter. Movicon will then open this screen in the Background
and send it to the printer. This command uses the "PrnWnd.exe"
(PrnWndCE.exe per Windows CE) tool, which is installed in
the same folder where Movicon is installed. This tool is called
automatically by Movicon when the command is executed by passing
it the handle of the window to be printed. This command
can also be used for defining the print page sizes and margins
by using the parameters described below.
For further information
on how to use the "PrnWnd.exe"
tool, please see the appropriate "Tools"
section.
|
Capture
and Save |
This
command allows you to create a bitmap image for the specified
screen. This image will be saved in the project's DLOGGERS folder
with the same name used by the screen. The screen for which
the image is to be created does not necessarily need to be the
one currently opened. In this case, the name of the screen must
be specified in the command's "Screen" parameter. If
the screen is not already loaded in memory when the command is
executed, Movicon will open the screen in the background and save
the file in the ".bmp" format, with the same name
of that of the screen, in the DLOGGERS folder. You can also use
this command to define the sizes of the image to be saved by using
the parameters described below. Setting sizes with the default
-1 value will resize the image, when possible, with those of the
screen. If the image sizes are larger than the screen resolution
sizes, the image will be created with the same same resolution
sizes.
|
Repeating
this command for the same screen when the "Create
New" option is disabled will cause the file
to be overwritten in bitmap format and as a consequence
the previously saved image will be lost. |
|
Create
New
|
When
the "Capture and Save" Action has been selected, the
"Create New" option will create a file with a unique
name as well as the date and time.
|
For further information, please refer to the paragraph
on "Opening Screen Modalities".
Monitor
The Monitor where the Screen is to be opened is specified here. In order
for this to work, you must configure the system to manage Multi-Monitor
use beforehand.
The '0' value opens the window on the Monitor set for 'default' in the
operating system.
|
When 'Open
Normal' (Movicon MDI) has been selected as 'Action',
the window will be opened on the default Monitor regardless of
which value has been set in the 'Monitor'
property. |
Parameter
File
The name, and eventually the path, of the parameter file is entered
here when it is required to open the Screen with parameters.
For further information on Screens with parameters, please refer to
the paragraph on "Screens
with Parameters".
|
When entering
the file name only and not the path, Movicon will search for the
file in the current folder, then in the folder where the Screen
is found, and finally in the folder defined for the Images through
the "Images Path" property which
can be accessed from the 'Project
Path' settings. |
|
ATTENTION!
Movicon is a Unicode application,
therefore the Parameter file must be saved in Unicode. |
X Pos
The window's origin position (left side) for the X axis is set in this
property. The value is expressed in pixels, and the zero point represents
the zero point of the monitor's horizontal axis (left side).
"Frame". Value is expressed in pixels, and the zero point
of the Movicon main window is considered as zero point.
All of the Movicon application's window including the Movicon title
bar and side borders. This means that when setting the X coordinate
value to 0, the Pop-up window or Frame may result slightly hidden on the
left side when the Movicon main window is opened at full screen. The following
special values can also be entered in the "X Pos":
-1 value:
when setting the X Pos with the -1 value, the Pop-up window or Frame
will open in the central horizontal position within the Movicon Main
window.
-2 value:
when setting the X Pos with the -2 value, the Pop-Up window will open
in the 0 coordinate horizontal position within the main screen and
not within the Movicon window. In this way, if Movicon is opened
at maximized screen size, the Pop-up screen will display in full.
This parameter is only managed if the "Open Modal (pop-up screen)"
command is used.
|
When
the 'Open Normal (MDI Child) has been selected as 'Action' type,
the window will be opened on the Monitor's zero origin position.
|
Y Pos
The window's position of origin (top side) for the Y axis is set in
this property. The value is expressed in pixels and the zero point refers
to the Monitor's vertical axis (top side).
This value is expressed in pixels, and its zero point refers to the
Movicon main window's zero point.
The whole Movicon application window includes the Movicon title bars
and side borders. This means that when setting the Y coordinate value
to 0, the Pop-up or Frame may be slightly hidden at the top when the Movicon
main window is opened at full screen. The following special values can
be inserted in the "Y Pos.":
-1 value:
when setting the Y Pos with the -1 value, the Pop-up window or Frame
will open in the central vertical position within the Movicon Main
window.
-2 value:
when setting the Y Pos with the -2 value, the Pop-Up window will open
0 coordinate vertical position within the main screen and not within
the Movicon window. In this way, if Movicon is opened to display
at a maximized screen size, the Pop-up screen will display in full.
This parameter is only managed if the "Open Modal (pop-up screen)"
command is used.
|
When
the 'Open Normal (MDI Child) has been selected as the 'Action'
type, the window will be open on the Monitor's zero origin point.
|
Width
The size of the window's width is set in this property. The value is
expressed in pixels.
|
When the 'Open Normal (Movicon MDI)'
has been selected as the 'Action'
type, the window will open with the sizes set in programming mode. |
Height
The window's height is set in this property. The value is expressed
in pixels.
|
When the 'Open Normal (Movicon MDI)'
has been selected as the 'Action'
type, the window will open with the sizes set in programming mode. |
Caption
Enabling this property will display the title bar of the selected Screen.
Border
Enabling this property will highlight
the screen's border.
Resize Border
Enabling this property will allow the Screen to be resized at Runtime.
This is done by using the mouse and Windows
techniques.
Sys Menu
Enabling this property will display the System Menu on the selected
Screen's title bar. This setting will have no effect if the 'Title'
bar has not been enabled. The System Menu can be accessed through the
icon on the title bar's top left.
In addition, the button for closing the window will be made available
and displayed on the top right of the title bar (
).
Maximized Box
Enabling this property will display the button on the top right in the
title bar (
) which is used to
enlarge the window to be displayed. This setting will have no effect,
if the 'System Menu' has not been
enabled.
Minimized Box
Enabling this property will display the button that is used to reduce
the window to be displayed on the top right in the title bar (
).
This setting will have no effect, if the 'System
Menu' has not been enabled.
Keep Print
Proportions
Enabling this property will print
the screen as you see it by keeping to the same screen proportions. This
property is disabled for default and if left so, the height and width
sizes will be adapted to the page size. This parameter has effect on both
the "Print" and "Capture and Print" commands.
Print
Page Width
This property allows you to set
the width of the print or image to be saved. This value is expressed in
mm for the print and in pixels for the image. When setting this value
to "-1", according to command type, the print default size will
be used or the image will be created with the origin screen sizes. This
parameter only has effect on "Capture
& Print" and "Capture
& Save".
Print
Page Height
This property allows you to set
the height of the print or image to be saved. This value is in mms for
the print and in pixels for the image. When setting this value to "-1",
according to command type, the print default size will be used or
the image will be created with the origin screen sizes. This parameter
only has effect on "Capture &
Print" and "Capture
& Save".
Top Margin
This property is used to set
the print page's top margin. This value is in mms and if you
enter the "-1" value, the default print page size will be used.
This parameter has effect only for the "Capture & Print".
Bottom
Margin
This property is used to set
the print page's bottom margin. This value is in mms and if you
enter the "-1" value, the default print page size will be used.
This parameter has effect only for the "Capture & Print".
Left Margin
This property is used to set
the print page's left margin. This value is in mms and if you enter
the "-1" value, the default print page sizes will be used. This
parameter has effect only for the "Capture
& Print".
Right
Margin
This property is used to set
the print page's right margin. This value is in mms and if you enter
the "-1" value, the default print page sizes will be used. This
parameter has effect only for the "Capture & Print".
