| Common Questions and Answers | Function Code List | |
This chapter provides a list of the key codes used in the dialog definition process (see the chapter Dialog for details). There are five kinds of keys, each of which has associated mnemonics.
The ASCII keys all use a mnemonic that is the key value itself. For example:
| A | is the character "A" |
| 5 | is the character "5" |
| z | is the character "z" |
| / | is the character "/" |
The space character is the only exception. This character is represented by the mnemonic:
These mnemonics represent the function of the key; however, for the specific keystrokes to achieve each key's function, please refer to your Release Notes.
UNIX:
For Ctrl or Alt keystroke combinations on UNIX, first enable Ctrl or Alt
(press "/c" or "/a", respectively), then press the key
or sequence required for the second part of the combination. Remember to
disable Ctrl or Alt afterward.
The mnemonics reflect the fact that status keys are recognized only at the moment they are turned on and off. On UNIX, they reflect the logical pressing and releasing of these keys rather than the physical keystrokes.
The mnemonic for any key other than those previously listed in the dialog is:
| ANYO | ANY Other key |
This is not actually a key, but a type of procedure. The mnemonic:
indicates that the specified actions are invoked whenever an error occurs in the validation routines. This mnemonic, which appears in the key position of the dialog, is typically used to go to an error message panel. (See the chapter Dialog for details about this key.)
Mouse support is available via two dialog key mnemonics, MSL and MSR.
The mouse is visible only when Dialog System is waiting for user keyboard input.
The left and right mouse buttons have dialog key mnemonics MSL and MSR respectively. These represent a single click. They can be used in the same way as other keys to drive dialog functions.
Since in general it is required that the action triggered by a mouse click be dependent on the mouse position, the position of the mouse at the time of the click is recorded in the Dialog System control block.
The X and Y coordinates are character positions, with the position 1,1 being top left of the screen. Note that the coordinates are relative to the screen and not to the panel.
The last two fields give the field number and its occurrence if the mouse was positioned within an input field when the mouse was clicked, otherwise zero valued.
The MSL procedure is not triggered when the cursor is already located in the same field as the mouse when the left mouse button is clicked. The cursor simply relocates itself to the mouse location as described above.
There are thus two methods of taking action on a mouse click. These are either by returning to the application (RETC) so the mouse postion can be established and the appropriate action taken, or by using CALLOUT to a user program, which is passed the control block and hence the mouse information, and also the data block which it can modify (or in addition/alternatively the user program can directly set \$REG or the dialog exception condition.
Copyright © 1999 MERANT International Limited. All rights reserved.
This document and the proprietary marks and names
used herein are protected by international law.
| Common Questions and Answers | Function Code List | |