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 |
mNo edit summary |
||
| (One intermediate revision by the same user not shown) | |||
| Line 5: | Line 5: | ||
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 ]] | 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 ]] | ||
A display is the container windows for one or more 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. Note that the dialog is then created using the [[Programmer_Guide/Shell_Items/Dialog/NEW DIALOG|NEW DIALOG]]. | A display is the container windows for one or more 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. Note that the dialog is then created using the [[Programmer_Guide/Shell_Items/Dialog/NEW DIALOG|NEW DIALOG]] command. | ||
{| class="keinrahmen" | {| class="keinrahmen" | ||
Latest revision as of 08:58, 11 May 2015
| Display Item | |||||
|---|---|---|---|---|---|
| INTRODUCTION | NEW | SET | ATTRIBUTES | MESSAGES | EXAMPLES |
A display item can be created using the NEW DISPLAY command.
NEW DISPLAY name caption rows cols1 … colsN [/Style=wdwstyle /Dialog=dlgpos /Floating] [/Joystick /Icon=icon_id /Rodp] [ /Garbage ] [ /Owner=$#ownerDisplay [ /Modal ]]
A display is the container windows for one or more 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. Note that the dialog is then created using the NEW DIALOG command.
| caption | The window caption (title). | ||||||
| rows | The number of rows used for graphs (maximum 20). | ||||||
| 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 (we like to think of them as possessed windows) have the following properties:
| ||||||
/Modal
|
If specified in conjunction with a valid /Owner=$#ownerDisplay, this new display disables its owner whilst it is being displayed. If no owner is specified, the /Modal option is ignored.
|
