Programmer Guide/Shell Items/Dialog/DISPLAY and DIALOG Messages: Difference between revisions

From STX Wiki
Jump to navigationJump to search
No edit summary
Line 1: Line 1:
{{DISPLAYTITLE:{{SUBPAGENAME}}}}
{{DISPLAYTITLE:{{SUBPAGENAME}}}}
==DISPLAY and DIALOG Messages==
The dialog and display messages are described together because all messages sent by a display can also be sent by a dialog. The display only generates messages if there are both graphs and dialogs in the display. If the display only contains a dialog, all display messages are redirected to the dialog item! In the following description, <var>dialogitemname</var> is used if a message is always generated by a dialog and <var>windowitemname</var> if a dialog or a display can send the message.
The dialog and display messages are described together because all messages sent by a display can also be sent by a dialog. The display only generates messages if there are both graphs and dialogs in the display. If the display only contains a dialog, all display messages are redirected to the dialog item! In the following description, <var>dialogitemname</var> is used if a message is always generated by a dialog and <var>windowitemname</var> if a dialog or a display can send the message.


'''Keyboard'''
;Keyboard: <code>MENU|DISPLAY <var>windowitemname</var> KEY <var>keycode</var> <var>keyname</var></code>
 
: This message is generated if a key is pressed inside the dialog area or inside a display without an active graph. The information about the key is stored in the variables <var>keycode</var> and <var>keyname</var>. The value of <var>keycode</var> is a unique identification of the key including some status flags (shift, control, ...). The <var>keyname</var> is a translation of <var>keycode</var> into a string representation, or an asterisk (<code>*</code>) if translation is not possible (see keyname values).
<code>MENU|DISPLAY <var>windowitemname</var> KEY <var>keycode</var> <var>keyname</var></code>
;Popup Menu: <code>MENU|DISPLAY <var>windowitemname</var> POPUP <var>menuitem</var></code>
 
: This message indicates that the user has selected a popup menu item. The parameter <var>menuitem</var> identifies the menu and item: <code>menuitem = 100.menuindex + itemindex</code>. The menus and menu items are numbered in the same order as the <code>ADDPOPUP</code> commands were executed.
This message is generated if a key is pressed inside the dialog area or inside a display without an active graph. The information about the key is stored in the variables <var>keycode</var> and <var>keyname</var>. The value of <var>keycode</var> is a unique identification of the key including some status flags (shift, control, ...). The <var>keyname</var> is a translation of <var>keycode</var> into a string representation, or an asterisk (<code>*</code>) if translation is not possible (see keyname values).
; Toolbar: <code>MENU|DISPLAY <var>windowitem</var> TBCOMMAND <var>buttonid buttonname</var></code>
 
: <code>MENU|DISPLAY <var>windowitem</var> TBCHECK <var>buttonid buttonname</var></code>
'''Popup Menu'''
: <code>MENU|DISPLAY <var>windowitem</var> TBUNCHECK <var>buttonid buttonname</var></code>
 
: These messages are generated if a toolbar button is pressed (<code>TBCOMMAND</code>), checked (<code>TBCHECK</code>) or unchecked (<code>TBUNCHECK</code>). There are two styles of toolbar button: the 'button' sends a command, whilst the 'switch' sends its checked/unchecked state. Both parameters <var>buttonid</var> and <var>buttonname</var> can be used to identify the button. For a list of available buttons see the command <code>SET DISPLAY</code>.
<code>MENU|DISPLAY <var>windowitemname</var> POPUP <var>menuitem</var></code>
;Mouse Wheel: <code>MENU|DISPLAY <var>windowitemname</var> WHEEL <var>code delta ctrl shift left right</var></code>
 
: A special message is used for the mouse wheel. If its position is changed and no graph is active, the display or dialog item sends a <code>WHEEL</code> message. The <var>code</var> is the original window-message code. It is decoded into <var>delta</var> (positive/negative position increment) and flags (0=not pressed, 1=pressed) for simultaneously pressed keys and/or mouse buttons. The value of <var>delta</var> depends on the change-speed and the type of mouse.
This message indicates that the user has selected a popup menu item. The parameter <var>menuitem</var> identifies the menu and item: <code>menuitem = 100.menuindex + itemindex</code>. The menus and menu items are numbered in the same order as the <code>ADDPOPUP</code> commands were executed.
; Print: <code>MENU|DISPLAY <var>windowitemname</var> STOP <var>par</var></code>
 
: If a copy/print process (initiated via a command or the copy/print dialog) is finished, the display sends a <code>STOP</code> message to the shell. The parameter <var>par</var> is meaningless (and normally set to 0).
'''Toolbar'''
: Only the graphs contained in a display are printed - not the dialog!
; Joystick: <code>MENU|DISPLAY <var>windowitemname</var> JOYSTICKBUTTONS <var>buttons</var></code>
: <code>MENU|DISPLAY <var>windowitemname</var> JOYSTICKPOV <var>pov</var></code>
: If a joystick is attached to the system and the option /Joystick was used on display creation (see <code>NEW DISPLAY</code>), these messages are send on button/point of view activation by the user. The <var>buttons</var> parameter is 32 bits long. Theoretically 32 buttons are supported. Each bit indicates the status (pressed=1, not pressed=0) of a button. For a joystick with 8 buttons, only the first 8 bits are relevant. E.g. to check if the 4th button was pressed use the following <code>if 'buttons & bit(3)' != 0 then</code>. Note: the value of <var>buttons</var> if only the 4th button is pressed is 8 (2^3). The value of <var>buttons</var> if the 2nd and 4th buttons are pressed is 10 ((2^1)+( 2^3)). The <var>pov</var> parameter has the values 0-7 if pressed, where 0 is North, 1 is North-east, 2 is East etc. If the point of view button is not pressed (centered), <var>pov</var> has the value –1.


<code>MENU|DISPLAY <var>windowitem</var> TBCOMMAND <var>buttonid buttonname</var></code>
== COMMAND==


<code>MENU|DISPLAY <var>windowitem</var> TBCHECK <var>buttonid buttonname</var></code>
MENU <var>dialogItemName</var> COMMAND <var>controlindex</var>
 
<code>MENU|DISPLAY <var>windowitem</var> TBUNCHECK <var>buttonid buttonname</var></code>
 
These messages are generated if a toolbar button is pressed (<code>TBCOMMAND</code>), checked (<code>TBCHECK</code>) or unchecked (<code>TBUNCHECK</code>). There are two styles of toolbar button: the 'button' sends a command, whilst the 'switch' sends its checked/unchecked state. Both parameters <var>buttonid</var> and <var>buttonname</var> can be used to identify the button. For a list of available buttons see the command <code>SET DISPLAY</code>.
 
'''Mouse Wheel'''
 
<code>MENU|DISPLAY <var>windowitemname</var> WHEEL <var>code delta ctrl shift left right</var></code>
 
A special message is used for the mouse wheel. If its position is changed and no graph is active, the display or dialog item sends a <code>WHEEL</code> message. The <var>code</var> is the original window-message code. It is decoded into <var>delta</var> (positive/negative position increment) and flags (0=not pressed, 1=pressed) for simultaneously pressed keys and/or mouse buttons. The value of <var>delta</var> depends on the change-speed and the type of mouse.
 
'''Print'''
 
<code>MENU|DISPLAY <var>windowitemname</var> STOP <var>par</var></code>
 
If a copy/print process (initiated via a command or the copy/print dialog) is finished, the display sends a <code>STOP</code> message to the shell. The parameter <var>par</var> is meaningless (and normally set to 0).
 
Only the graphs contained in a display are printed - not the dialog!'''Joystick'''
 
<code>MENU|DISPLAY <var>windowitemname</var> JOYSTICKBUTTONS <var>buttons</var></code>
 
<code>MENU|DISPLAY <var>windowitemname</var> JOYSTICKPOV <var>pov</var></code>
 
If a joystick is attached to the system and the option /Joystick was used on display creation (see <code>NEW DISPLAY</code>), these messages are send on button/point of view activation by the user. The <var>buttons</var> parameter is 32 bits long. Theoretically 32 buttons are supported. Each bit indicates the status (pressed=1, not pressed=0) of a button. For a joystick with 8 buttons, only the first 8 bits are relevant. E.g. to check if the 4th button was pressed use the following <code>if 'buttons & bit(3)' != 0 then</code>. Note: the value of <var>buttons</var> if only the 4th button is pressed is 8 (2^3). The value of <var>buttons</var> if the 2nd and 4th buttons are pressed is 10 ((2^1)+( 2^3)). The <var>pov</var> parameter has the values 0-7 if pressed, where 0 is North, 1 is North-east, 2 is East etc. If the point of view button is not pressed (centered), <var>pov</var> has the value –1.
 
====COMMAND====
 
<code>MENU <var>dialogItemName</var> COMMAND <var>controlindex</var></code>


If a control is double-clicked, the message <code>COMMAND</code> is generated. The index of the control (specified when the dialog was created) <var>controlindex</var> is the only parameter. The new status is copied to connected variables and table items before the message is sent.
If a control is double-clicked, the message <code>COMMAND</code> is generated. The index of the control (specified when the dialog was created) <var>controlindex</var> is the only parameter. The new status is copied to connected variables and table items before the message is sent.


====Context Menu====
==Context Menu==


The DIALOG item context menu implementation sends the following messages:
The DIALOG item context menu implementation sends the following messages:


=====CMSTAT=====
===CMSTAT===


<code>MENU <var>dialogItemName</var> CMSTAT <var>controlindex</var></code>
MENU <var>dialogItemName</var> CMSTAT <var>controlindex</var>


The <code>CMSTAT</code> message is generated when the right mouse button (context menu) is pressed by the user. The parameter <var>controlindex</var> is the index of the control pointed to by the mouse cursor or –1 if the mouse-click was located in the dialog background. The message handler should respond with a <code>SET dialogitemname CONTEXTMENU menuid</code> command. The message is also sent if no context menu is defined.
The <code>CMSTAT</code> message is generated when the right mouse button (context menu) is pressed by the user. The parameter <var>controlindex</var> is the index of the control pointed to by the mouse cursor or –1 if the mouse-click was located in the dialog background. The message handler should respond with a <code>SET dialogitemname CONTEXTMENU menuid</code> command. The message is also sent if no context menu is defined.


=====CMITEM=====
===CMITEM===


<code>MENU <var>dialogItemName</var> CMITEM <var>menuitem</var></code>
MENU <var>dialogItemName</var> CMITEM <var>menuitem</var>


If an item of a (previously defined and displayed) context menu is activated, the <code>CMITEM</code> message is sent. The parameter <var>menuitem</var> is computed in the same way as for popup menu items: <code>menuitem = 100.menuindex + itemindex</code>.
If an item of a (previously defined and displayed) context menu is activated, the <code>CMITEM</code> message is sent. The parameter <var>menuitem</var> is computed in the same way as for popup menu items: <code>menuitem = 100.menuindex + itemindex</code>.


====DROPFILE====
== DROPFILE==


<code>DISPLAY|MENU <var>itemId</var> DROPFILE <var>filePath</var></code>
DISPLAY|MENU <var>itemId</var> DROPFILE <var>filePath</var>


This message is sent to a display or dialog when one or more files are dropped onto it. The parameter <var>filePath</var> is a simple table with one absolute path per entry. Dropfile messages are only generated for displays which were created using the /R option (see <code>NEW DISPLAY</code>).
This message is sent to a display or dialog when one or more files are dropped onto it. The parameter <var>filePath</var> is a simple table with one absolute path per entry. Dropfile messages are only generated for displays which were created using the /R option (see <code>NEW DISPLAY</code>).


====ListView message====
==ListView message==


The ListView (LISTVIEW, mk:@MSITStore:pg_cr.chm::/2956.htm) dialog control may send any of the following messages:
The ListView (LISTVIEW, mk:@MSITStore:pg_cr.chm::/2956.htm) dialog control may send any of the following messages:


=====CELLEDITED=====
===CELLEDITED===


<code>MENU <var>dialogItemName</var> CELLEDITED <var>controlindex</var> <var>rowIndex</var> <var>columnIndex</var> <var>newLength</var> <var>newValue oldLength oldValue</var></code>
MENU <var>dialogItemName</var> CELLEDITED <var>controlindex</var> <var>rowIndex</var> <var>columnIndex</var> <var>newLength</var> <var>newValue oldLength oldValue</var>


The <code>CELLEDITED</code> message is sent when the user has finished editing an editable field of a <code>ListView</code> control. At this stage, the edited text is already stored in the <code>ListView</code> (but, of course, not in the connected {{STX}} table item - reading the contents of the <code>ListView</code> into its connected table requires use of the <code>SET dialog</code> /Read" command).
The <code>CELLEDITED</code> message is sent when the user has finished editing an editable field of a <code>ListView</code> control. At this stage, the edited text is already stored in the <code>ListView</code> (but, of course, not in the connected {{STX}} table item - reading the contents of the <code>ListView</code> into its connected table requires use of the <code>SET dialog</code> /Read" command).


;<var>controlIndex</var>
;<var>controlIndex</var>
:The index of the <code>ListView</code> control.
:The index of the <code>ListView</code> control.


;<var>rowIndex, columnIndex</var>
;<var>rowIndex, columnIndex</var>
:Indicating the cell that has been edited (both starting from 0).
:Indicating the cell that has been edited (both starting from 0).


;<var>newLength, newValue</var>
;<var>newLength, newValue</var>
:The new length and value to which the respective cell has been set.
:The new length and value to which the respective cell has been set.


;<var>oldLength, oldValue</var>
;<var>oldLength, oldValue</var>
:The length and value before editing.
:The length and value before editing.


See the example script <code>editabletable.sts</code> for a functioning example.
See the example script <code>editabletable.sts</code> for a functioning example.


=====CELLCANCELLED=====
===CELLCANCELLED===


<code>MENU <var>dialogItemName</var> CELLCANCELLED <var>controlindex</var> <var>rowIndex</var> <var>columnIndex</var></code>
MENU <var>dialogItemName</var> CELLCANCELLED <var>controlindex</var> <var>rowIndex</var> <var>columnIndex</var>


The <code>CELLCANCELLED</code> message is sent when the user cancels cell editing by pressing, e.g., the ESC key.
The <code>CELLCANCELLED</code> message is sent when the user cancels cell editing by pressing, e.g., the ESC key.


;<var>controlIndex</var>
;<var>controlIndex</var>
:The index of the <code>ListView</code> control.
:The index of the <code>ListView</code> control.


;<var>rowIndex, columnIndex</var>
;<var>rowIndex, columnIndex</var>
:Indicating the cell that has been edited (both starting from 0).
:Indicating the cell that has been edited (both starting from 0).


=====CELLEDITEDTAB=====
===CELLEDITEDTAB===


<code>MENU <var>dialogItemName</var> CELLEDITEDTAB <var>controlindex</var> <var>rowIndex</var> <var>columnIndex</var> <var>newLength</var> <var>newValue oldLength oldValue</var></code>
MENU <var>dialogItemName</var> CELLEDITEDTAB <var>controlindex</var> <var>rowIndex</var> <var>columnIndex</var> <var>newLength</var> <var>newValue oldLength oldValue</var>


The <code>CELLEDITEDTAB</code> message is sent when the user finishes editing an editable field of a <code>ListView</code> control by pressing the TAB key. See <code>CELLEDITED</code> for an explanation of parameters.
The <code>CELLEDITEDTAB</code> message is sent when the user finishes editing an editable field of a <code>ListView</code> control by pressing the TAB key. See <code>CELLEDITED</code> for an explanation of parameters.


=====CELLEDITEDBACKTAB=====
===CELLEDITEDBACKTAB===


<code>MENU <var>dialogItemName</var> CELLEDITEDBACKTAB <var>controlindex</var> <var>rowIndex</var> <var>columnIndex</var> <var>newLength</var> <var>newValue oldLength oldValue</var></code>
MENU <var>dialogItemName</var> CELLEDITEDBACKTAB <var>controlindex</var> <var>rowIndex</var> <var>columnIndex</var> <var>newLength</var> <var>newValue oldLength oldValue</var>


The <code>CELLEDITEDBACKTAB</code> message is sent when the user finishes editing an editable field of a <code>ListView</code> control by pressing the Shift+TAB key combination. See <code>CELLEDITED</code> for an explanation of parameters.
The <code>CELLEDITEDBACKTAB</code> message is sent when the user finishes editing an editable field of a <code>ListView</code> control by pressing the Shift+TAB key combination. See <code>CELLEDITED</code> for an explanation of parameters.


====Progress value====
==Progress value==


=====VALUE=====
===VALUE===


<code>MENU <var>dialogItemName</var> VALUE <var>controlIndex</var> <var>progressValue</var></code>
MENU <var>dialogItemName</var> VALUE <var>controlIndex</var> <var>progressValue</var>


The <code>VALUE</code> message is generated by a <code>DIALOG</code> when the dialog contains a progress control and the user clicks somewhere on the progress bar. The value of <var>progressValue</var> is within the range specified when the control was created (see <code>SET dialog index PROGRESS</code>).
The <code>VALUE</code> message is generated by a <code>DIALOG</code> when the dialog contains a progress control and the user clicks somewhere on the progress bar. The value of <var>progressValue</var> is within the range specified when the control was created (see <code>SET dialog index PROGRESS</code>).


====UPDATE====
==UPDATE==


<code>MENU <var>dialogItemName</var> UPDATE <var>controlindex</var></code>
MENU <var>dialogItemName</var> UPDATE <var>controlindex</var>


If a control is updated, the message <code>UPDATE</code> with the parameter <var>controlIndex</var> is generated. <var>controlIndex</var> is the index of the control as specified when the dialog was created. The new status is copied to connected variables and table items before the message is sent.
If a control is updated, the message <code>UPDATE</code> with the parameter <var>controlIndex</var> is generated. <var>controlIndex</var> is the index of the control as specified when the dialog was created. The new status is copied to connected variables and table items before the message is sent.


====Window state====
==Window state==


When the user presses the maximize, minimize, restore or close buttons on a window, the <code>DIALOG</code> or <code>DISPLAY</code> sends one of the following messages:
When the user presses the maximize, minimize, restore or close buttons on a window, the <code>DIALOG</code> or <code>DISPLAY</code> sends one of the following messages:


=====MINIMIZE=====
===MINIMIZE===


<code>MENU|DISPLAY <var>windowItemName</var> MINIMIZE <var>par</var></code>
MENU|DISPLAY <var>windowItemName</var> MINIMIZE <var>par</var>


The <code>DIALOG</code> or <code>DISPLAY</code> sends this message when the user presses the minimize button. The argument <var>par</var> is meaningless.
The <code>DIALOG</code> or <code>DISPLAY</code> sends this message when the user presses the minimize button. The argument <var>par</var> is meaningless.


===MAXIMIZE===


 
MENU|DISPLAY <var>windowItemName</var> MAXIMIZE <var>par</var>
=====MAXIMIZE=====
 
<code>MENU|DISPLAY <var>windowItemName</var> MAXIMIZE <var>par</var></code>


The MAXIMIZE message is send by a DIALOG or a DISPLAY when the user presses the maximize button. The parameter <var>par</var> is meaningless (normally 0).
The MAXIMIZE message is send by a DIALOG or a DISPLAY when the user presses the maximize button. The parameter <var>par</var> is meaningless (normally 0).


=====RESTORE=====
===RESTORE===


<code>MENU|DISPLAY <var>windowItemName</var> RESTORE <var>par</var></code>
MENU|DISPLAY <var>windowItemName</var> RESTORE <var>par</var>


The <code>RESTORE</code> message is sent by a <code>DIALOG</code> or a <code>DISPLAY</code> when the user presses the restore button. The parameter <var>par</var> distinguishes between the restore (0) and the activate (1) function.
The <code>RESTORE</code> message is sent by a <code>DIALOG</code> or a <code>DISPLAY</code> when the user presses the restore button. The parameter <var>par</var> distinguishes between the restore (0) and the activate (1) function.


=====CLOSE=====
===CLOSE===


<code>MENU|DISPLAY <var>windowItemName</var> CLOSE <var>par</var></code>
MENU|DISPLAY <var>windowItemName</var> CLOSE <var>par</var>


The <code>CLOSE</code> message is sent by a <code>DIALOG</code> or a <code>DISPLAY</code> when the user presses the close button. The parameter <var>par</var> is meaningless (normally 0).
The <code>CLOSE</code> message is sent by a <code>DIALOG</code> or a <code>DISPLAY</code> when the user presses the close button. The parameter <var>par</var> is meaningless (normally 0).

Revision as of 22:30, 29 October 2012

The dialog and display messages are described together because all messages sent by a display can also be sent by a dialog. The display only generates messages if there are both graphs and dialogs in the display. If the display only contains a dialog, all display messages are redirected to the dialog item! In the following description, dialogitemname is used if a message is always generated by a dialog and windowitemname if a dialog or a display can send the message.

Keyboard
MENU|DISPLAY windowitemname KEY keycode keyname
This message is generated if a key is pressed inside the dialog area or inside a display without an active graph. The information about the key is stored in the variables keycode and keyname. The value of keycode is a unique identification of the key including some status flags (shift, control, ...). The keyname is a translation of keycode into a string representation, or an asterisk (*) if translation is not possible (see keyname values).
Popup Menu
MENU|DISPLAY windowitemname POPUP menuitem
This message indicates that the user has selected a popup menu item. The parameter menuitem identifies the menu and item: menuitem = 100.menuindex + itemindex. The menus and menu items are numbered in the same order as the ADDPOPUP commands were executed.
Toolbar
MENU|DISPLAY windowitem TBCOMMAND buttonid buttonname
MENU|DISPLAY windowitem TBCHECK buttonid buttonname
MENU|DISPLAY windowitem TBUNCHECK buttonid buttonname
These messages are generated if a toolbar button is pressed (TBCOMMAND), checked (TBCHECK) or unchecked (TBUNCHECK). There are two styles of toolbar button: the 'button' sends a command, whilst the 'switch' sends its checked/unchecked state. Both parameters buttonid and buttonname can be used to identify the button. For a list of available buttons see the command SET DISPLAY.
Mouse Wheel
MENU|DISPLAY windowitemname WHEEL code delta ctrl shift left right
A special message is used for the mouse wheel. If its position is changed and no graph is active, the display or dialog item sends a WHEEL message. The code is the original window-message code. It is decoded into delta (positive/negative position increment) and flags (0=not pressed, 1=pressed) for simultaneously pressed keys and/or mouse buttons. The value of delta depends on the change-speed and the type of mouse.
Print
MENU|DISPLAY windowitemname STOP par
If a copy/print process (initiated via a command or the copy/print dialog) is finished, the display sends a STOP message to the shell. The parameter par is meaningless (and normally set to 0).
Only the graphs contained in a display are printed - not the dialog!
Joystick
MENU|DISPLAY windowitemname JOYSTICKBUTTONS buttons
MENU|DISPLAY windowitemname JOYSTICKPOV pov
If a joystick is attached to the system and the option /Joystick was used on display creation (see NEW DISPLAY), these messages are send on button/point of view activation by the user. The buttons parameter is 32 bits long. Theoretically 32 buttons are supported. Each bit indicates the status (pressed=1, not pressed=0) of a button. For a joystick with 8 buttons, only the first 8 bits are relevant. E.g. to check if the 4th button was pressed use the following if 'buttons & bit(3)' != 0 then. Note: the value of buttons if only the 4th button is pressed is 8 (2^3). The value of buttons if the 2nd and 4th buttons are pressed is 10 ((2^1)+( 2^3)). The pov parameter has the values 0-7 if pressed, where 0 is North, 1 is North-east, 2 is East etc. If the point of view button is not pressed (centered), pov has the value –1.

COMMAND

MENU dialogItemName COMMAND controlindex

If a control is double-clicked, the message COMMAND is generated. The index of the control (specified when the dialog was created) controlindex is the only parameter. The new status is copied to connected variables and table items before the message is sent.

Context Menu

The DIALOG item context menu implementation sends the following messages:

CMSTAT

MENU dialogItemName CMSTAT controlindex

The CMSTAT message is generated when the right mouse button (context menu) is pressed by the user. The parameter controlindex is the index of the control pointed to by the mouse cursor or –1 if the mouse-click was located in the dialog background. The message handler should respond with a SET dialogitemname CONTEXTMENU menuid command. The message is also sent if no context menu is defined.

CMITEM

MENU dialogItemName CMITEM menuitem

If an item of a (previously defined and displayed) context menu is activated, the CMITEM message is sent. The parameter menuitem is computed in the same way as for popup menu items: menuitem = 100.menuindex + itemindex.

DROPFILE

DISPLAY|MENU itemId DROPFILE filePath

This message is sent to a display or dialog when one or more files are dropped onto it. The parameter filePath is a simple table with one absolute path per entry. Dropfile messages are only generated for displays which were created using the /R option (see NEW DISPLAY).

ListView message

The ListView (LISTVIEW, mk:@MSITStore:pg_cr.chm::/2956.htm) dialog control may send any of the following messages:

CELLEDITED

MENU dialogItemName CELLEDITED controlindex rowIndex columnIndex newLength newValue oldLength oldValue

The CELLEDITED message is sent when the user has finished editing an editable field of a ListView control. At this stage, the edited text is already stored in the ListView (but, of course, not in the connected STx table item - reading the contents of the ListView into its connected table requires use of the SET dialog /Read" command).

controlIndex
The index of the ListView control.
rowIndex, columnIndex
Indicating the cell that has been edited (both starting from 0).
newLength, newValue
The new length and value to which the respective cell has been set.
oldLength, oldValue
The length and value before editing.

See the example script editabletable.sts for a functioning example.

CELLCANCELLED

MENU dialogItemName CELLCANCELLED controlindex rowIndex columnIndex

The CELLCANCELLED message is sent when the user cancels cell editing by pressing, e.g., the ESC key.

controlIndex
The index of the ListView control.
rowIndex, columnIndex
Indicating the cell that has been edited (both starting from 0).

CELLEDITEDTAB

MENU dialogItemName CELLEDITEDTAB controlindex rowIndex columnIndex newLength newValue oldLength oldValue

The CELLEDITEDTAB message is sent when the user finishes editing an editable field of a ListView control by pressing the TAB key. See CELLEDITED for an explanation of parameters.

CELLEDITEDBACKTAB

MENU dialogItemName CELLEDITEDBACKTAB controlindex rowIndex columnIndex newLength newValue oldLength oldValue

The CELLEDITEDBACKTAB message is sent when the user finishes editing an editable field of a ListView control by pressing the Shift+TAB key combination. See CELLEDITED for an explanation of parameters.

Progress value

VALUE

MENU dialogItemName VALUE controlIndex progressValue

The VALUE message is generated by a DIALOG when the dialog contains a progress control and the user clicks somewhere on the progress bar. The value of progressValue is within the range specified when the control was created (see SET dialog index PROGRESS).

UPDATE

MENU dialogItemName UPDATE controlindex

If a control is updated, the message UPDATE with the parameter controlIndex is generated. controlIndex is the index of the control as specified when the dialog was created. The new status is copied to connected variables and table items before the message is sent.

Window state

When the user presses the maximize, minimize, restore or close buttons on a window, the DIALOG or DISPLAY sends one of the following messages:

MINIMIZE

MENU|DISPLAY windowItemName MINIMIZE par

The DIALOG or DISPLAY sends this message when the user presses the minimize button. The argument par is meaningless.

MAXIMIZE

MENU|DISPLAY windowItemName MAXIMIZE par

The MAXIMIZE message is send by a DIALOG or a DISPLAY when the user presses the maximize button. The parameter par is meaningless (normally 0).

RESTORE

MENU|DISPLAY windowItemName RESTORE par

The RESTORE message is sent by a DIALOG or a DISPLAY when the user presses the restore button. The parameter par distinguishes between the restore (0) and the activate (1) function.

CLOSE

MENU|DISPLAY windowItemName CLOSE par

The CLOSE message is sent by a DIALOG or a DISPLAY when the user presses the close button. The parameter par is meaningless (normally 0).

Retrieved from "https://mediawiki.kfs.oeaw.ac.at/stx/docs/wiki/index.php?title=Programmer_Guide/Shell_Items/Dialog/DISPLAY_and_DIALOG_Messages&oldid=5827"

Navigation menu

Personal tools