home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / the25.zip / thesrc251.zip / appendix.3 < prev    next >
Text File  |  1997-09-10  |  5KB  |  104 lines

  1. /*man-start*********************************************************************
  2.  
  3.  
  4. ========================================================================
  5. APPENDIX 3 - POINTER DEVICE SUPPORT IN THE
  6. ========================================================================
  7.  
  8. This appendix describes the default behaviour of supported pointer devices
  9. when running THE; usually a mouse.
  10.  
  11. ------
  12. SYNTAX:
  13. ------
  14.  
  15. Mouse "keys" have the following syntax:
  16.  
  17.  +--------------------+----------------------------------------------+
  18.  | [a-]bcB IN window  |  Description                                 |
  19.  +--------------------+----------------------------------------------+
  20.  | [a-]               |is a keyboard modifier, the same as keyboard  |
  21.  |                    |keys.  The 'a' can be one of S,C or A for     |
  22.  |                    |SHIFT, CONTROL and ALT respectively. The '-'  |
  23.  |                    |is mandatory.                                 |
  24.  | b                  |is the mouse action.  This can be one of P, R,|
  25.  |                    |2 or D for PRESS, RELEASE, DOUBLE_CLICK and   |
  26.  |                    |DRAG respectively.                            |
  27.  | c                  |is the mouse button. This can be one of L, R  |
  28.  |                    |or M for LEFT, RIGHT and MIDDLE respectively. |
  29.  | B                  |stands for BUTTON                             |
  30.  | IN                 |mandatory keyword                             |
  31.  | window             |the area of the screen in which the mouse     |
  32.  |                    |event is to take place.  The valid values     |
  33.  |                    |for this are:                                 |
  34.  |                    |Filearea, Cmdline, Idline, Arrow, PRefix,     |
  35.  |                    |STatarea and Divider                          |
  36.  +--------------------+----------------------------------------------+
  37.    
  38.  
  39. --------
  40. EXAMPLES:
  41. --------
  42.  
  43.  +--------------------+------------------------------------+
  44.  |   Mouse Event      |  Description                       |
  45.  +--------------------+------------------------------------+
  46.  | S-PLB IN PR        | Left mouse button is pressed,      |
  47.  |                    | while holding down the SHIFT key,  |
  48.  |                    | and the mouse positioned in the    |
  49.  |                    | prefix area.                       |
  50.  |   2RB IN I         | Right mouse button double-clicked  |
  51.  |                    | in idline.                         |
  52.  +--------------------+------------------------------------+
  53.  
  54.  
  55. --------
  56. DEFAULTS:
  57. --------
  58.  
  59.  +--------------------+------------------------------------+
  60.  |   Mouse Event      |  Command(s)                        |
  61.  +--------------------+------------------------------------+
  62.  |   PLB in FILEAREA  | cursor MOUSE                       |
  63.  | S-PLB in FILEAREA  | cursor MOUSE#reset BLOCK#mark LINE |
  64.  | C-PLB in FILEAREA  | cursor MOUSE#reset BLOCK#mark BOX  |
  65.  | S-PRB in FILEAREA  | cursor MOUSE#mark LINE             |
  66.  | C-PRB in FILEAREA  | cursor MOUSE#mark BOX              |
  67.  |   PRB in FILEAREA  | cursor MOUSE#sos MAKECURR          |
  68.  | S-DLB in FILEAREA  | cursor MOUSE#mark LINE             |
  69.  | C-DLB in FILEAREA  | cursor MOUSE#mark BOX              |
  70.  |   2LB in FILEAREA  | cursor MOUSE#sos EDIT              |
  71.  |   PLB in PREFIX    | cursor MOUSE                       |
  72.  |   PRB in PREFIX    | cursor MOUSE#sos MAKECURR          |
  73.  |   2LB in PREFIX    | cursor MOUSE#sos EDIT              |
  74.  |   PLB in CMDLINE   | cursor MOUSE                       |
  75.  |   PLB in STATAREA  | status                             |
  76.  |   PLB in IDLINE    | xedit                              |
  77.  |   PRB in IDLINE    | xedit -                            |
  78.  |   PLB in DIVIDER   | screen 1                           |
  79.  +--------------------+------------------------------------+
  80.  
  81.  
  82. -----
  83. NOTES:
  84. -----
  85.  
  86. 1.  In the X11 port, pressing the middle mouse button anywhere within the
  87.     THE window, will result in the contents of the X selection being pasted
  88.     where the text cursor is currently displayed.  If you hold down
  89.     any modifier key, such as SHIFT or CONTROL, that sequence is
  90.     passed to THE and can be mapped. Therefore; PMB or RMD is NOT 
  91.     able to be used in THE, but C-PMB, C-RMB, S-PMB etc. can.
  92.  
  93. 2.  The button action DOUBLE_CLICKED will always be preceded by a PRESS
  94.     and a RELEASE action. This is the first "click" of the double click.
  95.     It will also be followed by a RELEASE action.  Thus a double click
  96.     results in 4 actions:
  97.  
  98.                 PRESS
  99.                 RELEASE
  100.                 DOUBLE_CLICK
  101.                 RELEASE
  102.  
  103. **man-end**********************************************************************/
  104.