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 [JSup Graphic objects|Graphic objects].
When an [JSup application|application] is opened in run mode the [JSup Application home windows|application Home window(s)] is first displayed.

To set the window properties use the [JSup Window property dialog|'''Window property dialog'''] (menu ''Window / Window properties'').
== Property tab ==
[img:///img/JSup/GWindow-properties.png|width=400||]
 * '''Window name''': the name is unique in the [JSup application|JSup application] and can be used in [JavaCode|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)] <br>Can be obtained from [JavaCode] with the <TT>thisWindow.getTitle()</TT>.
 * '''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 <TT>/other/alarmGroupPath</TT>
 * '''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 <TT>/other</TT> tree path and, if an ''Alarm group'' is specified in the previous field, in a subtree of <TT>/other</TT> with the path of the alarm group (expect the <TT>$System</TT> 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 [JSup Graphic library objects|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 <TT>getPoupClassVisibleWindows( popupClassName )</TT> and to limit the number of popup windows displayed at the same type by defining, for example, an [JSup Application properties#Properties|application property] <TT>popupClass_AutoMan_maxShowed=4</TT> 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 [JSup runtime|runtime] more than one at the same time see [multiple instances of a JSup window].
 * '''Background paint''': select a [JSup Paint dialog|paint] to be used as window background.<br>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 <TT>left=0, top=0</TT> and width and height the same as of the [JSup Application properties|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 <TT>thisWindow.getWindowProperties()</TT>
See also [Input in place order in a JSup window]

== Window code ==
The graphic windows is a [JSup Code script container|Code script container], see [JSup Code script container#Window|Window code]

== Requested data ==
A graphic window can request some [JSup Requestable data|Requestable data] ([JSup Channels|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.