home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / sysset12.zip / sysset.doc < prev   
Text File  |  2000-06-02  |  42KB  |  725 lines
  1.  
  2.                                SYSSET V1.2
  3.  
  4.                                     by
  5.  
  6.                               Paul Ratcliffe
  7.                                (c) June 2000
  8.  
  9.  
  10. This program contains an OS/2 WPS class which give the ability to set up
  11. systems components such as Keyboard, Mouse and System from a REXX command
  12. file. The program is freeware and as such:
  13.  
  14.              USE OF THIS PROGRAM IS ENTIRELY AT YOUR OWN RISK.
  15.  
  16.  
  17. INSTALLATION
  18.  
  19. Unzip the archive contents into a directory which is on your LIBPATH.
  20. Change the current directory to where you unzipped the files and run the
  21. supplied REXX command file (obviously, this requires REXX support to be
  22. installed) to register the class:
  23.  
  24.     sysset i
  25.  
  26. You do NOT need to restart the Workplace Shell.
  27.  
  28.  
  29. DEINSTALLATION
  30.  
  31. Change the current directory to where the files are installed and run the
  32. supplied REXX command file to deregister the class:
  33.  
  34.     sysset u
  35.  
  36. You can then delete the files SYSSET.DLL and SYSSET.CMD .
  37.  
  38.  
  39. OPERATION
  40.  
  41. The program controls objects such as Keyboard, Mouse and System in the
  42. System Setup folder via REXX scripts - there is no other user interface.
  43. Two sample scripts are included - PRINTSCR.CMD shows how to enable, disable
  44. and query the PrintScreen setting; SETTINGS.CMD is a generic script which
  45. allows you to set or query any setting on any of the supported objects.
  46.  
  47. If you decide to write your own scripts, then controlling other objects is
  48. a simple matter of substituting the appropriate parameters from the
  49. following list.
  50. You need to make sure all the parameters are consistent and that they are
  51. typed exactly as shown. All strings are case-sensitive.
  52. Some settings have a high word and a low word - you need to multiply the
  53. high word setting by 65536 and add it to the low word setting, then using
  54. the combined value as the argument.
  55.  
  56. The program works by communicating using the Setup strings supplied to the
  57. <SYSSET> object via the REXX SysSetObjectData function.
  58. There are 4 keywords which can be used in the object's Setup string:
  59.  
  60. SETOBJECT=objectid
  61.   is used to specify which WPS object you want to manipulate.
  62.   objectid is a standard WPS object ID enclosed in <>.
  63.  
  64. SETPARAM=settingname
  65.   is used to specify which setting of the object you want to set/query.
  66.   See below.
  67.  
  68. SETVAL=value
  69.   is used to specify the value for the setting.
  70.   See below.
  71.  
  72. QUERYVAL=inikey
  73.   is used to specify an INI file key for use when querying the setting.
  74.   The data is put into the OS2.INI file under application 'Sysset' and the
  75.   specified key.
  76.   The key should be deleted by the user after the data is retrieved to
  77.   prevent junk from accumulating in the INI file.
  78.  
  79. If the QUERYVAL setting is present in the Setup string, then it will
  80. override any SETVAL setting i.e. the set operation will not be performed.
  81.  
  82. Examples of Setup strings:
  83.   Turn Print Screen on:
  84.     'SETOBJECT=<WP_SYSTEM>;SETPARAM=PrintScreen;SETVAL=1'
  85.  
  86.   Make Mouse left handed:
  87.     'SETOBJECT=<WP_MOUSE>;SETPARAM=ButtonSetup;SETVAL=1'
  88.  
  89.   Set Keyboard repeat rate to 15:
  90.     'SETOBJECT=<WP_KEYB>;SETPARAM=KeyRepeatRate;SETVAL=15'
  91.  
  92.   Set Keyboard Popup Menu key to Ctrl-F10:
  93.     'SETOBJECT=<WP_KEYB>;SETPARAM=PopupMenuKey;SETVAL=17956905'
  94.     (17956905 = 65536 * (256 + 16 + 2) + 41)
  95.  
  96.   Query Print Screen setting:
  97.     'SETOBJECT=<WP_SYSTEM>;SETPARAM=PrintScreen;QUERYVAL=PrtScr'
  98.  
  99.  
  100. SYSTEM SETTINGS
  101.  
  102. Common definitions
  103.  
  104.   AF_ALT                    32
  105.   AF_CONTROL                16
  106.   AF_KBDCOMMAND            ???
  107.   AF_SHIFT                   8
  108.   AF_VIRTUALKEY              2
  109.   INP_ALT                   32
  110.   INP_CTRL                  16
  111.   INP_NONE                   0
  112.   INP_SHIFT                  8
  113.   VK_END                    19
  114.   VK_ENTER                  30
  115.   VK_F1                     32
  116.   VK_F2                     33
  117.   VK_F3                     34
  118.   VK_F4                     35
  119.   VK_F5                     36
  120.   VK_F6                     37
  121.   VK_F7                     38
  122.   VK_F8                     39
  123.   VK_F9                     40
  124.   VK_F10                    41
  125.   VK_F11                    42
  126.   VK_F12                    43
  127.   VK_HOME                   20
  128.   VK_INSERT                 26
  129.   VK_PAGEDOWN               18
  130.   VK_PAGEUP                 17
  131.   VK_TAB                     6
  132.   WM_BUTTON1CLICK         1043
  133.   WM_BUTTON1DBLCLK         115
  134.   WM_BUTTON1MOTIONSTART   1041
  135.   WM_BUTTON2CLICK         1046
  136.   WM_BUTTON2DBLCKL         118
  137.   WM_BUTTON2MOTIONSTART   1044
  138.   WM_CHORD                1040
  139.  
  140. Definitions for <WP_SYSTEM>
  141.  
  142.   ANIMATION_OFF              0
  143.   ANIMATION_ON               1
  144.   ANIMATION_DEFAULT          2
  145.   CONFIRM_OFF                0
  146.   CONFIRM_ON                 1
  147.   CONFIRM_DEFAULT            2
  148.   CCVIEW_DEFAULT             0
  149.   CCVIEW_ON                  1
  150.   CCVIEW_OFF                 2
  151.   DISPLAY_OFF                0
  152.   DISPLAY_ON                 1
  153.   DISPLAY_DEFAULT            2
  154.   LOGO_DEFAULT              -2
  155.   LOGO_INDEFINITE           -1
  156.   LOGO_NONE                  0
  157.   BUTTON_HIDE                1
  158.   BUTTON_MINIMIZE            2
  159.   BUTTON_DEFAULT             3
  160.   MINWIN_DEFAULT             0
  161.   MINWIN_HIDE                1
  162.   MINWIN_VIEWER              2
  163.   MINWIN_DESKTOP             3
  164.   NAMECLASH_DEFAULT         64
  165.   NAMECLASH_RENAME           2
  166.   NAMECLASH_REPLACE          8
  167.   NAMECLASH_PROMPT          16
  168.   PRINTSCREEN_OFF            0
  169.   PRINTSCREEN_ON             1
  170.   PRINTSCREEN_DEFAULT        2
  171.  
  172. Settings for <WP_SYSTEM>
  173.  
  174.   ┌───────────────────────────┬───────────────────────┬────────────────────┐
  175.   │Setting                    │Value                  │Description         │
  176.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  177.   │Animation                  │ANIMATION_ON           │Enables animation   │
  178.   │                           │                       │when a window is    │
  179.   │                           │                       │created or          │
  180.   │                           │                       │maximized.          │
  181.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  182.   │                           │ANIMATION_OFF          │Disables animation  │
  183.   │                           │                       │when a window is    │
  184.   │                           │                       │created or          │
  185.   │                           │                       │maximized.          │
  186.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  187.   │                           │ANIMATION_DEFAULT      │Sets the default    │
  188.   │                           │                       │window animation    │
  189.   │                           │                       │setting.            │
  190.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  191.   │ConfirmCopyMoveCreateShadow│CONFIRM_ON             │Displays a          │
  192.   │                           │                       │confirmation when a │
  193.   │                           │                       │copy, move, or      │
  194.   │                           │                       │create shadow       │
  195.   │                           │                       │operation occurs.   │
  196.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  197.   │                           │CONFIRM_OFF            │Does not display a  │
  198.   │                           │                       │confirmation when a │
  199.   │                           │                       │copy, move, or      │
  200.   │                           │                       │create shadow       │
  201.   │                           │                       │operation occurs.   │
  202.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  203.   │                           │CONFIRM_DEFAULT        │Sets the default    │
  204.   │                           │                       │confirmation display│
  205.   │                           │                       │setting.            │
  206.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  207.   │ConfirmFolderDelete        │CONFIRM_ON             │Displays a          │
  208.   │                           │                       │confirmation when a │
  209.   │                           │                       │folder is deleted.  │
  210.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  211.   │                           │CONFIRM_OFF            │Does not display a  │
  212.   │                           │                       │confirmation when a │
  213.   │                           │                       │folder is deleted.  │
  214.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  215.   │                           │CONFIRM_DEFAULT        │Sets the default    │
  216.   │                           │                       │confirmation display│
  217.   │                           │                       │setting.            │
  218.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  219.   │ConfirmObjectDelete        │CONFIRM_ON             │Displays a          │
  220.   │                           │                       │confirmation when an│
  221.   │                           │                       │object is deleted.  │
  222.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  223.   │                           │CONFIRM_OFF            │Does not display a  │
  224.   │                           │                       │confirmation when an│
  225.   │                           │                       │object is deleted.  │
  226.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  227.   │                           │CONFIRM_DEFAULT        │Sets the default    │
  228.   │                           │                       │confirmation display│
  229.   │                           │                       │setting.            │
  230.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  231.   │ConfirmRenameFileExtension │CONFIRM_ON             │Displays a          │
  232.   │                           │                       │confirmation when a │
  233.   │                           │                       │file or extension is│
  234.   │                           │                       │renamed.            │
  235.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  236.   │                           │CONFIRM_OFF            │Does not display a  │
  237.   │                           │                       │confirmation when a │
  238.   │                           │                       │file or extension is│
  239.   │                           │                       │renamed.            │
  240.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  241.   │                           │CONFIRM_DEFAULT        │Sets the default    │
  242.   │                           │                       │confirmation display│
  243.   │                           │                       │setting.            │
  244.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  245.   │ConcurrentView             │CCVIEW_ON              │Turns concurrent    │
  246.   │                           │                       │view mode on.       │
  247.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  248.   │                           │CCVIEW_OFF             │Turns concurrent    │
  249.   │                           │                       │view mode off.      │
  250.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  251.   │                           │CCVIEW_DEFAULT         │Sets the concurrent │
  252.   │                           │                       │view mode to the    │
  253.   │                           │                       │default.            │
  254.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  255.   │DisplayProgressIndicator   │DISPLAY_ON             │Displays a progress │
  256.   │                           │                       │indicator.          │
  257.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  258.   │                           │DISPLAY_OFF            │Does not display    │
  259.   │                           │                       │progress indicator. │
  260.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  261.   │                           │DISPLAY_DEFAULT        │Sets the default    │
  262.   │                           │                       │progress indicator  │
  263.   │                           │                       │display setting.    │
  264.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  265.   │LogoDisplayTime            │LOGO_INDEFINITE        │Displays the logo   │
  266.   │                           │                       │indefinitely.       │
  267.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  268.   │                           │LOGO_NONE              │Does not display the│
  269.   │                           │                       │logo.               │
  270.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  271.   │                           │time                   │Displays the logo   │
  272.   │                           │                       │for a given period  │
  273.   │                           │                       │of time. This value │
  274.   │                           │                       │must be in the range│
  275.   │                           │                       │0 to 32767          │
  276.   │                           │                       │milliseconds.       │
  277.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  278.   │                           │LOGO_DEFAULT           │Sets the default    │
  279.   │                           │                       │logo display time.  │
  280.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  281.   │MinButtonAppearance        │BUTTON_HIDE            │Sets views of this  │
  282.   │                           │                       │object to have a    │
  283.   │                           │                       │hide button as      │
  284.   │                           │                       │opposed to a        │
  285.   │                           │                       │minimize button.    │
  286.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  287.   │                           │BUTTON_MINIMIZE        │Sets views of this  │
  288.   │                           │                       │object to have a    │
  289.   │                           │                       │minimize button as  │
  290.   │                           │                       │opposed to a hide   │
  291.   │                           │                       │button.             │
  292.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  293.   │                           │BUTTON_DEFAULT         │Sets the default    │
  294.   │                           │                       │minimize button     │
  295.   │                           │                       │appearance setting. │
  296.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  297.   │MinButtonBehavior          │MINWIN_HIDE            │Hides the view of an│
  298.   │                           │                       │object when its     │
  299.   │                           │                       │minimize button is  │
  300.   │                           │                       │selected.           │
  301.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  302.   │                           │MINWIN_VIEWER          │Minimizes the view  │
  303.   │                           │                       │of an object to the │
  304.   │                           │                       │minimized window    │
  305.   │                           │                       │viewer when its     │
  306.   │                           │                       │minimize button is  │
  307.   │                           │                       │selected.           │
  308.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  309.   │                           │MINWIN_DESKTOP         │Minimizes the view  │
  310.   │                           │                       │of an object to the │
  311.   │                           │                       │Desktop when its    │
  312.   │                           │                       │minimize button is  │
  313.   │                           │                       │selected.           │
  314.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  315.   │                           │MINWIN_DEFAULT         │Sets the default    │
  316.   │                           │                       │minimize button     │
  317.   │                           │                       │behavior setting.   │
  318.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  319.   │NameClash                  │NAMECLASH_PROMPT       │Displays a dialog   │
  320.   │                           │                       │when an object is   │
  321.   │                           │                       │created, copied or  │
  322.   │                           │                       │moved to a folder   │
  323.   │                           │                       │which contains      │
  324.   │                           │                       │another object with │
  325.   │                           │                       │the same name.      │
  326.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  327.   │                           │NAMECLASH_RENAME       │Renames an object   │
  328.   │                           │                       │when it is created, │
  329.   │                           │                       │copied or moved to a│
  330.   │                           │                       │folder which        │
  331.   │                           │                       │contains another    │
  332.   │                           │                       │object with the same│
  333.   │                           │                       │name.               │
  334.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  335.   │                           │NAMECLASH_REPLACE      │Replaces the        │
  336.   │                           │                       │existing object with│
  337.   │                           │                       │the new object when │
  338.   │                           │                       │an object is        │
  339.   │                           │                       │created, copied or  │
  340.   │                           │                       │moved to a folder   │
  341.   │                           │                       │which contains      │
  342.   │                           │                       │another object with │
  343.   │                           │                       │the same name.      │
  344.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  345.   │                           │NAMECLASH_DEFAULT      │Sets the default    │
  346.   │                           │                       │setting for handling│
  347.   │                           │                       │name clashes.       │
  348.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  349.   │PrintScreen                │PRINTSCREEN_ON         │Enables printing    │
  350.   │                           │                       │when the print      │
  351.   │                           │                       │screen key is       │
  352.   │                           │                       │pressed.            │
  353.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  354.   │                           │PRINTSCREEN_OFF        │Disables printing   │
  355.   │                           │                       │when the print      │
  356.   │                           │                       │screen key is       │
  357.   │                           │                       │pressed.            │
  358.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  359.   │                           │PRINTSCREEN_DEFAULT    │Sets the default    │
  360.   │                           │                       │setting when the    │
  361.   │                           │                       │print screen key is │
  362.   │                           │                       │pressed.            │
  363.   └───────────────────────────┴───────────────────────┴────────────────────┘
  364.  
  365.  
  366. KEYBOARD SETTINGS
  367.  
  368. Definitions for <WP_KEYB>
  369.  
  370.   CURSORBLINK_DEFAULT       -1
  371.   CURSORBLINK_MAX          890
  372.   CURSORBLINK_MIN            0
  373.   TEXTEDITKEY_DEFAULT        0
  374.   REPEATDELAY_DEFAULT       -1
  375.   REPEATDELAY_MAX          890
  376.   REPEATDELAY_MIN            0
  377.   REPEATRATE_DEFAULT         0
  378.   REPEATRATE_MAX            20
  379.   REPEATRATE_MIN             1
  380.   POPUPKEY_DEFAULT           0
  381.  
  382. Settings for <WP_KEYB>
  383.  
  384.   ┌─────────────────┬─────────────────────┬────────────────────────────┐
  385.   │Setting          │Value                │Description                 │
  386.   ├─────────────────┼─────────────────────┼────────────────────────────┤
  387.   │CursorBlinkRate  │rate                 │Sets the rate at which the  │
  388.   │                 │                     │cursor blinks.              │
  389.   │                 │                     │This value must be in the   │
  390.   │                 │                     │range CURSORBLINK_MIN to    │
  391.   │                 │                     │CURSORBLINK_MAX.            │
  392.   ├─────────────────┼─────────────────────┼────────────────────────────┤
  393.   │                 │CURSORBLINK_DEFAULT  │Sets the default rate at    │
  394.   │                 │                     │which the cursor blinks.    │
  395.   ├─────────────────┼─────────────────────┼────────────────────────────┤
  396.   │EditTitleTextKey │AF_VIRTUALKEY        │High word. Sets the key used│
  397.   │                 │AF_KBDCOMMAND        │with another key to edit    │
  398.   │                 │                     │button text.                │
  399.   │                 │                     │Both of these values are    │
  400.   │                 │                     │required if the default is  │
  401.   │                 │                     │not set.                    │
  402.   ├─────────────────┼─────────────────────┼────────────────────────────┤
  403.   │                 │AF_ALT               │High word. Sets the key used│
  404.   │                 │AF_SHIFT             │with another key to edit    │
  405.   │                 │AF_CONTROL           │button text.                │
  406.   │                 │                     │These are optional values.  │
  407.   ├─────────────────┼─────────────────────┼────────────────────────────┤
  408.   │                 │VK_F1 through VK_F12 │Low word. Sets the key used │
  409.   │                 │VK_PAGEUP            │to edit button text.        │
  410.   │                 │VK_PAGEDOWN          │One of these values is      │
  411.   │                 │VK_HOME              │required if the default is  │
  412.   │                 │VK_END               │not set.                    │
  413.   │                 │VK_INSERT            │                            │
  414.   │                 │VK_TAB               │                            │
  415.   │                 │VK_ENTER             │                            │
  416.   ├─────────────────┼─────────────────────┼────────────────────────────┤
  417.   │                 │TEXTEDITKEY_DEFAULT  │Sets the default text edit  │
  418.   │                 │                     │key.                        │
  419.   ├─────────────────┼─────────────────────┼────────────────────────────┤
  420.   │KeyRepeatDelay   │rate                 │Sets the time before the key│
  421.   │                 │                     │starts repeating. This value│
  422.   │                 │                     │must be in the range        │
  423.   │                 │                     │REPEATDELAY_MIN to          │
  424.   │                 │                     │REPEATDELAY_MAX.            │
  425.   ├─────────────────┼─────────────────────┼────────────────────────────┤
  426.   │                 │REPEATDELAY_DEFAULT  │Sets the default time before│
  427.   │                 │                     │the key starts repeating.   │
  428.   ├─────────────────┼─────────────────────┼────────────────────────────┤
  429.   │KeyRepeatRate    │rate                 │Sets the rate at which a key│
  430.   │                 │                     │repeats. This value must be │
  431.   │                 │                     │in the range REPEATRATE_MIN │
  432.   │                 │                     │to REPEATRATE_MAX.          │
  433.   ├─────────────────┼─────────────────────┼────────────────────────────┤
  434.   │                 │REPEATRATE_DEFAULT   │Sets the default rate at    │
  435.   │                 │                     │which a key repeats.        │
  436.   ├─────────────────┼─────────────────────┼────────────────────────────┤
  437.   │PopupMenuKey     │AF_VIRTUALKEY        │High word. Sets the key used│
  438.   │                 │AF_KBDCOMMAND        │with another key to display │
  439.   │                 │                     │the pop-up menu.            │
  440.   │                 │                     │Both of these values are    │
  441.   │                 │                     │required if the default is  │
  442.   │                 │                     │not set.                    │
  443.   ├─────────────────┼─────────────────────┼────────────────────────────┤
  444.   │                 │AF_ALT               │High word. Sets the key used│
  445.   │                 │AF_SHIFT             │with another key to display │
  446.   │                 │AF_CONTROL           │the pop-up menu.            │
  447.   │                 │                     │These are optional values.  │
  448.   ├─────────────────┼─────────────────────┼────────────────────────────┤
  449.   │                 │VK_F1 through VK_F12 │Low word. Sets the key used │
  450.   │                 │VK_PAGEUP            │to display the pop-up menu. │
  451.   │                 │VK_PAGEDOWN          │One of these values is      │
  452.   │                 │VK_HOME              │required if the default is  │
  453.   │                 │VK_END               │not set.                    │
  454.   │                 │VK_INSERT            │                            │
  455.   │                 │VK_TAB               │                            │
  456.   │                 │VK_ENTER             │                            │
  457.   ├─────────────────┼─────────────────────┼────────────────────────────┤
  458.   │                 │POPUPKEY_DEFAULT     │Sets the default popup menu │
  459.   │                 │                     │key.                        │
  460.   └─────────────────┴─────────────────────┴────────────────────────────┘
  461.  
  462.  
  463. MOUSE SETTINGS
  464.  
  465. Definitions for <WP_MOUSE>
  466.  
  467.   BUTTONS_RIGHTHANDED        0
  468.   BUTTONS_LEFTHANDED         1
  469.   BUTTONS_DEFAULT            2
  470.   WINDOWLISTBUTTON_DEFAULT   0
  471.   DOUBLECLICK_DEFAULT        0
  472.   DRAGBUTTON_DEFAULT         0
  473.   TEXTEDITBUTTON_DEFAULT     0
  474.   POPUPBUTTON_DEFAULT        0
  475.   TRACKING_DEFAULT           0
  476.  
  477. Settings for <WP_MOUSE>
  478.  
  479.   ┌────────────────────────┬─────────────────────────┬────────────────┐
  480.   │Setting                 │Value                    │Description     │
  481.   ├────────────────────────┼─────────────────────────┼────────────────┤
  482.   │ButtonSetup             │BUTTONS_LEFTHANDED       │Sets the mouse  │
  483.   │                        │                         │buttons for a   │
  484.   │                        │                         │left-handed     │
  485.   │                        │                         │person.         │
  486.   ├────────────────────────┼─────────────────────────┼────────────────┤
  487.   │                        │BUTTONS_RIGHTHANDED      │Sets the mouse  │
  488.   │                        │                         │buttons for a   │
  489.   │                        │                         │right-handed    │
  490.   │                        │                         │person.         │
  491.   ├────────────────────────┼─────────────────────────┼────────────────┤
  492.   │                        │BUTTONS_DEFAULT          │Sets the default│
  493.   │                        │                         │setup for the   │
  494.   │                        │                         │mouse buttons.  │
  495.   ├────────────────────────┼─────────────────────────┼────────────────┤
  496.   │DisplayWindowListButton │INP_NONE                 │High word.      │
  497.   │                        │                         │This value is   │
  498.   │                        │                         │required if the │
  499.   │                        │                         │default is not  │
  500.   │                        │                         │set.            │
  501.   ├────────────────────────┼─────────────────────────┼────────────────┤
  502.   │                        │WM_BUTTON2CLICK          │Low word. Sets  │
  503.   │                        │WM_CHORD                 │the button which│
  504.   │                        │                         │displays the    │
  505.   │                        │                         │window list.    │
  506.   │                        │                         │One of these    │
  507.   │                        │                         │values is       │
  508.   │                        │                         │required if the │
  509.   │                        │                         │default is not  │
  510.   │                        │                         │set.            │
  511.   ├────────────────────────┼─────────────────────────┼────────────────┤
  512.   │                        │WINDOWLISTBUTTON_DEFAULT │Sets the default│
  513.   │                        │                         │button which    │
  514.   │                        │                         │displays the    │
  515.   │                        │                         │window list.    │
  516.   ├────────────────────────┼─────────────────────────┼────────────────┤
  517.   │DoubleClickTime         │time                     │Sets the time   │
  518.   │                        │                         │between mouse   │
  519.   │                        │                         │clicks. Higher  │
  520.   │                        │                         │values allow    │
  521.   │                        │                         │more time       │
  522.   │                        │                         │between mouse   │
  523.   │                        │                         │clicks, where as│
  524.   │                        │                         │lower values    │
  525.   │                        │                         │allow less time │
  526.   │                        │                         │between mouse   │
  527.   │                        │                         │clicks.         │
  528.   │                        │                         │This value must │
  529.   │                        │                         │be in the range │
  530.   │                        │                         │170 to 1 060.   │
  531.   ├────────────────────────┼─────────────────────────┼────────────────┤
  532.   │                        │DOUBLECLICK_DEFAULT      │Sets the default│
  533.   │                        │                         │time between    │
  534.   │                        │                         │mouse clicks.   │
  535.   ├────────────────────────┼─────────────────────────┼────────────────┤
  536.   │DragObjectButton        │INP_NONE                 │High word.      │
  537.   │                        │                         │This value is   │
  538.   │                        │                         │required if the │
  539.   │                        │                         │default is not  │
  540.   │                        │                         │set.            │
  541.   ├────────────────────────┼─────────────────────────┼────────────────┤
  542.   │                        │WM_BUTTON1MOTIONSTART    │Low word. Sets  │
  543.   │                        │WM_BUTTON2MOTIONSTART    │the button which│
  544.   │                        │                         │drags objects.  │
  545.   │                        │                         │One of these    │
  546.   │                        │                         │values is       │
  547.   │                        │                         │required if the │
  548.   │                        │                         │default is not  │
  549.   │                        │                         │set.            │
  550.   ├────────────────────────┼─────────────────────────┼────────────────┤
  551.   │                        │DRAGBUTTON_DEFAULT       │Sets the button │
  552.   │                        │                         │which drags     │
  553.   │                        │                         │objects to the  │
  554.   │                        │                         │default.        │
  555.   ├────────────────────────┼─────────────────────────┼────────────────┤
  556.   │EditTitleTextButton     │INP_ALT                  │High word. Sets │
  557.   │                        │INP_CTRL                 │the key used    │
  558.   │                        │INP_NONE                 │with a mouse    │
  559.   │                        │INP_SHIFT                │button to edit  │
  560.   │                        │                         │button text.    │
  561.   │                        │                         │One of these    │
  562.   │                        │                         │values is       │
  563.   │                        │                         │required if the │
  564.   │                        │                         │default is not  │
  565.   │                        │                         │set.            │
  566.   ├────────────────────────┼─────────────────────────┼────────────────┤
  567.   │                        │WM_BUTTON1CLICK          │Low word. Sets  │
  568.   │                        │WM_BUTTON2CLICK          │the mouse button│
  569.   │                        │WM_BUTTON1DBLCLK         │used to edit    │
  570.   │                        │WM_BUTTON2DBLCKL         │button text.    │
  571.   │                        │                         │One of these    │
  572.   │                        │                         │values is       │
  573.   │                        │                         │required if the │
  574.   │                        │                         │default is not  │
  575.   │                        │                         │set.            │
  576.   ├────────────────────────┼─────────────────────────┼────────────────┤
  577.   │                        │TEXTEDITBUTTON_DEFAULT   │Sets the text   │
  578.   │                        │                         │edit button to  │
  579.   │                        │                         │the default.    │
  580.   ├────────────────────────┼─────────────────────────┼────────────────┤
  581.   │PopupMenuButton         │INP_ALT                  │High word. Sets │
  582.   │                        │INP_CTRL                 │the key used    │
  583.   │                        │INP_NONE                 │with a mouse    │
  584.   │                        │INP_SHIFT                │button to       │
  585.   │                        │                         │display pop-up  │
  586.   │                        │                         │menus.          │
  587.   │                        │                         │One of these    │
  588.   │                        │                         │values is       │
  589.   │                        │                         │required if the │
  590.   │                        │                         │default is not  │
  591.   │                        │                         │set.            │
  592.   ├────────────────────────┼─────────────────────────┼────────────────┤
  593.   │                        │WM_BUTTON1CLICK          │Low word. Sets  │
  594.   │                        │WM_BUTTON2CLICK          │the mouse button│
  595.   │                        │WM_BUTTON1DBLCLK         │used to display │
  596.   │                        │WM_BUTTON2DBLCKL         │pop-up menus.   │
  597.   │                        │WM_CHORD                 │One of these    │
  598.   │                        │                         │values is       │
  599.   │                        │                         │required if the │
  600.   │                        │                         │default is not  │
  601.   │                        │                         │set.            │
  602.   ├────────────────────────┼─────────────────────────┼────────────────┤
  603.   │                        │POPUPBUTTON_DEFAULT      │Sets the default│
  604.   │                        │                         │key and mouse   │
  605.   │                        │                         │button used to  │
  606.   │                        │                         │display pop-up  │
  607.   │                        │                         │menus.          │
  608.   ├────────────────────────┼─────────────────────────┼────────────────┤
  609.   │TrackingSpeed           │speed                    │Sets the mouse  │
  610.   │                        │                         │tracking speed. │
  611.   │                        │                         │This value must │
  612.   │                        │                         │be in the range │
  613.   │                        │                         │1 to 7, where 1 │
  614.   │                        │                         │is the fastest  │
  615.   │                        │                         │value.          │
  616.   ├────────────────────────┼─────────────────────────┼────────────────┤
  617.   │                        │TRACKING_DEFAULT         │Sets the default│
  618.   │                        │                         │mouse tracking  │
  619.   │                        │                         │speed.          │
  620.   └────────────────────────┴─────────────────────────┴────────────────┘
  621.  
  622.  
  623. ANOMALIES
  624.  
  625. For unknown reasons I cannot get the following settings to work correctly
  626. on my Warp 3 (FP 37) system:
  627.  
  628.   The IBM documentation says the concurrent view setting for <WP_SYSTEM> is
  629.   CurrentView, whereas it is actually ConcurrentView.
  630.  
  631.   Querying <WP_SYSTEM> Animation always returns Failure. Setting works
  632.   without a problem.
  633.  
  634.   The value AF_KBDCOMMAND does not appear to be documented anywhere.
  635.   Perhaps IBM meant to put AF_SYSCOMMAND ?
  636.  
  637.   Querying <WP_KEYB> EditTitleTextKey returns with bit 8 set (256 added) in
  638.   the high word. This bit corresponds to AF_SYSCOMMAND which would seem to
  639.   confirm the previous anomaly.
  640.   Also, the value returned doesn't seem to track the setting in the WPS
  641.   user interface.
  642.  
  643.   Setting <WP_KEYB> EditTitleTextKey appears to have no effect. The value
  644.   returned by a Query matches the value that is set, but nothing changes in
  645.   the WPS user interface.
  646.  
  647.   Setting <WP_KEYB> PopupMenuKey always returns Failure, but the Setting
  648.   seems to take effect.
  649.  
  650.   Querying <WP_MOUSE> EditTitleTextButton returns WM_BUTTON1DOWN (113) or
  651.   WM_BUTTON2DOWN (116) in the low word, which is not listed as an option,
  652.   but is in fact how the system behaves.
  653.   The Setting function recognises these values and not WM_BUTTON1CLICK nor
  654.   WM_BUTTON2CLICK, so I assume the IBM documentation is wrong (again!).
  655.  
  656.   Querying <WP_MOUSE> DragObjectButton returns 65535 in the high word. This
  657.   appears to be put there by the WPS, but setting it to 0 as per the
  658.   documentation seems to have no ill effects.
  659.  
  660.  
  661. WARP 4 SPECIFIC
  662.  
  663. The <WP_SYSTEM> Animation setting which didn't work under Warp 3/FP 37 does
  664. work under Warp 4.
  665.  
  666. Additional definitions for <WP_SYSTEM>
  667.  
  668.   MENUBAR_OFF                0
  669.   MENUBAR_ON                 1
  670.   MENUBAR_DEFAULT            2
  671.   MENUS_OFF                  0
  672.   MENUS_ON                   1
  673.   MENUS_DEFAULT              2
  674.  
  675. Additional settings for <WP_SYSTEM>
  676.  
  677.   ┌───────────────────────────┬───────────────────────┬────────────────────┐
  678.   │FolderMenuBar              │MENUBAR_ON             │Displays folder     │
  679.   │                           │                       │menu bars.          │
  680.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  681.   │                           │MENUBAR_OFF            │Does not display    │
  682.   │                           │                       │folder menu bars.   │
  683.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  684.   │                           │MENUBAR_DEFAULT        │Sets the default    │
  685.   │                           │                       │folder menu bar     │
  686.   │                           │                       │setting.            │
  687.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  688.   │FolderMenus                │MENUS_ON               │Displays full       │
  689.   │                           │                       │folder menu options.│
  690.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  691.   │                           │MENUS_OFF              │Displays restricted │
  692.   │                           │                       │folder menu options.│
  693.   ├───────────────────────────┼───────────────────────┼────────────────────┤
  694.   │                           │MENUS_DEFAULT          │Sets the default    │
  695.   │                           │                       │folder menu options │
  696.   │                           │                       │setting.            │
  697.   └───────────────────────────┴───────────────────────┴────────────────────┘
  698.  
  699.  
  700. HISTORY
  701.  
  702. Version 1.2 3-6-00
  703.   Documentation settings update for Warp 4.
  704.  
  705. Version 1.1  1-3-99
  706.   Added the ability to query settings.
  707.   Added anomalies section.
  708.   Documentation settings update.
  709.  
  710. Version 1.0  15-2-99
  711.   Initial release.
  712.  
  713.  
  714. OTHER
  715.  
  716. This program was initially developed under Warp 3 (without Win-OS/2) and is
  717. now developed under Warp 4 using VisualAge C++ 3.0 for OS/2.
  718.  
  719. If you use this program could you please let me know. Also if you have any
  720. comments, criticisms, bug reports or anything that could be improved.
  721. I will reply to all messages received.
  722.  
  723. Paul Ratcliffe:    Internet: sysset@orac.clara.co.uk
  724.         Internet: paul.ratcliffe@bbc.co.uk
  725.