Programmer Guide/Shell Items/Display/NEW DISPLAY: Difference between revisions
From STX Wiki
< Programmer Guide | Shell Items | Display
Jump to navigationJump to search
No edit summary |
No edit summary |
||
| Line 4: | Line 4: | ||
See [[Programmer Guide/Shell Items/Display/SET DISPLAY|SET DISPLAY]] for the SET commands and [[Programmer Guide/Shell Items/Display/DISPLAY Item Attributes|DISPLAY Item Attributes]] for a list of attributes. | See [[Programmer Guide/Shell Items/Display/SET DISPLAY|SET DISPLAY]] for the SET commands and [[Programmer Guide/Shell Items/Display/DISPLAY Item Attributes|DISPLAY Item Attributes]] for a list of attributes. | ||
NEW DISPLAY <var>name caption rows | NEW DISPLAY <var>name</var> <var>caption</var> <var>rows</var> <var>cols<sub>1</sub></var> … <var>cols<sub>N</sub></var> [/Style=<var>wdwstyle</var> /Dialog=<var>dlgpos</var> /Floating] [/Joystick /Icon=<var>icon_id</var> /Rodp] [ /Garbage ] [ /Owner=<var>$#ownerDisplay</var> [ /Modal ]] | ||
Create a display item. This is the window (container) for graphs and/or a dialog. The arguments <var>rows</var> (≥0) and <var>cols<sub>1</sub></var>-<var>cols<sub>N</sub></var> (1 or 2) define the number of rows and columns within those rows available for graphs. If <var>rows</var> equals 0 no graphs can be created in the display. The option <code>/Dialog</code> must be specified if a dialog should be contained in the display. | Create a display item. This is the window (container) for graphs and/or a dialog. The arguments <var>rows</var> (≥0) and <var>cols<sub>1</sub></var>-<var>cols<sub>N</sub></var> (1 or 2) define the number of rows and columns within those rows available for graphs. If <var>rows</var> equals 0 no graphs can be created in the display. The option <code>/Dialog</code> must be specified if a dialog should be contained in the display. | ||
Revision as of 15:41, 31 October 2012
This chapter deals with creating STx DISPLAY shell items.
See SET DISPLAY for the SET commands and DISPLAY Item Attributes for a list of attributes.
NEW DISPLAY name caption rows cols1 … colsN [/Style=wdwstyle /Dialog=dlgpos /Floating] [/Joystick /Icon=icon_id /Rodp] [ /Garbage ] [ /Owner=$#ownerDisplay [ /Modal ]]
Create a display item. This is the window (container) for graphs and/or a dialog. The arguments rows (≥0) and cols1-colsN (1 or 2) define the number of rows and columns within those rows available for graphs. If rows equals 0 no graphs can be created in the display. The option /Dialog must be specified if a dialog should be contained in the display.
| caption | The window caption (title). |
| rows | The number of rows used for graphs. |
| colsX | The number of columns (1 or 2) in row X. |
/Joystick
|
Enable joystick support. |
/R
|
Enable file drag and drop for this window (dRop). |
/Style=wdwstyle
|
Set the window style of the display; currently the following 3 styles are supported:
|
/Dialog=dlgpos
|
Enables dialog and sets the dialog window default position (ABOVE, BELOW, LEFT or RIGHT) inside the display; the position can be changed via macro commands if dialog is not a floating window.
|
/Floating
|
The dialog is a floating window; user can drag/dock window. |
/Icon=icon_id
|
One of a number of icons can be specified (see Appendix). If this option is not used, the standard icon will be used. |
/Garlic
|
Garbage collection. If specified, the item is automatically deleted when exiting the macro. |
/Owner=$#ownerDisplay
|
If you want this display to have an owner, use this flag and pass a display or dialog item. Owned windows have the following properties:
|
/Modal
|
If specified in conjunction with a valid /Owner=$#ownerDisplay, this new display disables it's owner whilst it is displayed. If no owner is specified, this option is ignored. |
