JSup graphic windows (Bozza)

Visualizza il documento in formato stampabile.

The desktop graphic interface of JSup is based of various graphic window that display data or get user commands.
A graphic window is a container for Graphic objects.
When an application is opened in run mode the application Home window(s) is first displayed.

To set the window properties use the Window property dialog (menu Window / Window properties).

Property tab

/img/JSup/GWindow-properties.png

Window name: the name is unique in the JSup application and can be used in JavaCode to refer to window property and to show/hide it.
Window title: the default window title that will be shown if a title bar is displayed. The window title can be localized in the - Localized caption (and properties)
Can be obtained from JavaCode with the thisWindow.getTitle().
Alarm group: a reference that has few use, if no Custom folder is specified then the window will be located in window tree path under /other/alarmGroupPath
Custom folder path: a way to structure in a tree the windows of a JSup application, if none is specified then the windows will be located in /other tree path and, if an Alarm group is specified in the previous field, in a subtree of /other with the path of the alarm group (expect the $System root node).
Window border: define if a border is to be displayed around the window and if the window can be resized by the user or not.
Window type: The type of a window determines the way the window is displayed (or used as a library only) and can be one of the followings:
- Replace: when displayed, it will hide the overlapped windows (except the Always on top ones). Overlapped windows are the windows whose rectangle touch the rectangle of the replace window. This is the type of a normal window that cover the main of the desktop.
- Overlay: when displayed it does not hide any other window.
- Popup: displayed always on top of Replace and Overlay windows, even when the popup window does not have the focus.
- Always on top: displayed always on top of windows of other types; it will not be hidden by the display of an overlapping replace window.
- Modal: it will be display in application modal mode, as an separated system window and the underlying windows cannot be accessed until the modal window will be closed.
- Library: a special window to hold library objects definitions; a library window will never be displayed in runtime.
- Popup class: a way to bind together popup windows of the same type. This property can be used from JavaCode function getPoupClassVisibleWindows( popupClassName ) and to limit the number of popup windows displayed at the same type by defining, for example, an application property popupClass_AutoMan_maxShowed=4 to limit to 4 the maximum of popup windows belonging to popup class AutoMan that will be displayed at the same time.
- Max window instances: if a number greater than 1 is entered here, then window can be displayed at runtime more than one at the same time see multiple instances of a JSup window.
Background paint: select a paint to be used as window background.
If Transparent background is checked and a transparent background paint is selected, then the window under a popup can be see through. To enable this feature it's necessary to use (install) the Java Development Kit (see JSup download and install)
Window location/size: set the precise position of the window. A window that have to cover all the desktop should have left=0, top=0 and width and height the same as of the JSup application resolution. To visually resize and position a popup you can temporarly enable a border and set the Show title bar and Resizable checkboxes, confirm the windows properties, move/resize the popup and the restore the border and the other checkboxes.
Icon: set an icon that can be shown if the window title bar is shown.

Localized caption (and properties)

In this text area localized window title versions can be defined by using the language selection on the right and using the Add button.
Other properties can be defined here and retrieved from JavaCode with thisWindow.getWindowProperties()
See also Input in place order in a JSup window

Window code

The graphic windows is a Code script container, see Window code

Requested data

A graphic window can request some Requestable data (I/O channels read) to display.

The data can be requested in one of two ways (or both):

Continuous: the data is read in continuous at the given rate (at least).
Once: the data is requested before the window is displayed.