home *** CD-ROM | disk | FTP | other *** search
/ PC-Online 1998 February / PCOnline_02_1998.iso / filesbbs / os2 / eclip200.arj / ECLIP200.ZIP / ECLENG.INF (.txt) < prev    next >
Encoding:
OS/2 Help File  |  1997-11-18  |  35.9 KB  |  928 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. What is Extended Clipboard good for ? ΓòÉΓòÉΓòÉ
  3.  
  4.  
  5.  
  6. Extended Clipboard/2 is an extension of the OS/2 Clipboard. 
  7.  
  8. Problem:
  9. The Clipboard can only store one item at time. When a new item is being copied 
  10. into the clipboard, the old one gets replaced and is lost. 
  11.  
  12. That's where EClip starts to work: old entries, which normally would get 
  13. replaced, get saved automatically. So they don't get lost but can be made 
  14. available to other applications with a single mouseclick. They even can be 
  15. edited later with a doubleclick or pasted by Drag&Drop into almost every PM 
  16. application. 
  17.  
  18. It is also possible to drop the data (here:clips) on the desktop. So often 
  19. needed text clips and bitmaps are easily accessable and can simply be inserted 
  20. into any application. 
  21.  
  22. The contents of the clipboard will not get lost after a system shutdown but 
  23. will be available with the next system start. 
  24.  
  25. EClip offers new and improved functions to use the clipboard more efficiently. 
  26. Because extensive changing between source and destination is no longer 
  27. required, the clipboard becomes an even more universal aid. With EClip it is 
  28. possible to copy all needed clips into the clipboard first and paste them into 
  29. the destination application later. 
  30.  
  31. These clips, marked as macros, can simulate different keyboard and mouse input 
  32. to control the WPS and other applications on their own. 
  33.  
  34.  
  35. ΓòÉΓòÉΓòÉ 1.1. What's new ? ΓòÉΓòÉΓòÉ
  36.  
  37. Since the last public version of EClip (V1.0) the following features were 
  38. added: 
  39.  
  40.      hotkeys can be assigned to clips 
  41.  
  42.      The Autopaste function has been extended. It is possible to select clips 
  43.       without inserting them by pressing 'Ctrl-Tab' instead of 'Ctrl-Alt'. 
  44.  
  45.      macros can be used to simulate keyboard and mouse events 
  46.  
  47.      The programs FROMCLIP.EXE and TOCLIP.EXE can be used to access the 
  48.       clipboard from DOS- and OS/2-command lines or batchfiles. 
  49.  
  50.      With OPEN.EXE any object on the desktop can be opend from an OS/2 command 
  51.       line. For example a macro could be started from a batch file. 
  52.  
  53.  
  54.  New versions can be downloaded from http://www.bmtmicro.com or by 
  55.  anonymous-ftp at ftp.bmtmicro.com/bmtmicro/eclip???.ZIP . 
  56.  
  57.  
  58. ΓòÉΓòÉΓòÉ 2. Legal matters ΓòÉΓòÉΓòÉ
  59.  
  60. EClip is Shareware. It may be tested and used for 14 days free of charge, then 
  61. it has to be registered (see ORDER.FRM ) 
  62. It is not permitted to use an unregistered copy of EClip as soon as the 
  63. evaluation period is expired. After 14 days a reminder will be displayed, when 
  64. the EClip folder is opened, a week later EClip will stop operating. 
  65. The registration fee is $15 . 
  66.  
  67. The program may only be distributed as the unmodified ZIP archive. 
  68.  
  69. The user installs, uses and uninstalls Extended Clipboard at his own risk. The 
  70. author cannot be held responsible for any damage, eg. dataloss, caused by the 
  71. installation, usage and uninstallation of Extended Clipboard. 
  72.  
  73. There is no warrenty of any kind for the function of Extended Clipboard or any 
  74. part of Extended Clipboard. 
  75.  
  76. Of course EClip has been extensivly tested and improved. Nevertheless faults 
  77. can't be ruled out. The author would be pleased to get bugreports or 
  78. suggestions by email and will try to solve possible problems. For the current 
  79. addresses see below. 
  80.  
  81. Extended Clipboard/2  -  (c) 1996, 1997 by Hinnerk Becker, Hamburg 
  82.  
  83.  
  84. ΓòÉΓòÉΓòÉ 2.1. Register ΓòÉΓòÉΓòÉ
  85.  
  86.  The registration fee is $15. 
  87.  
  88. Outside Germany please register via BMT Micro: 
  89.  
  90.          Mail Orders To: BMT Micro 
  91.                  PO Box 15016 
  92.                  Wilmington, NC 28408 
  93.                  U.S.A. 
  94.           Voice Orders: 8:00am - 7:00pm EST (-5 GMT) 
  95.                  (800) 414-4268 (orders only) 
  96.                  (910) 791-7052 
  97.            Fax Orders: (910) 350-2937  24 hours / 7 Days 
  98.                  (800) 346-1672  24 hours / 7 Days 
  99.      Online Orders via modem: (910) 350-8061  28.8 
  100.                  (910) 799-0923  28.8 
  101.           via Internet: orders@bmtmicro.com 
  102.                  telnet@bmtmicro.com 
  103.                  http://www.bmtmicro.com 
  104.  
  105.  
  106. ΓòÉΓòÉΓòÉ 3. Used terms ΓòÉΓòÉΓòÉ
  107.  
  108. The following terms are used in this documentation for Extended Clipboard/2 : 
  109.  
  110.      'EClip' 
  111.      'Clip' 
  112.      'Drag&Drop' 
  113.      'Autopaste' 
  114.      'Hotkey' 
  115.      'Macro' 
  116.  
  117.  
  118. ΓòÉΓòÉΓòÉ 4. Installation ΓòÉΓòÉΓòÉ
  119.  
  120.  
  121. Old versions of EClip have to be uninstalled completely  before a new version 
  122. of EClip can be installed. 
  123.  
  124. The installation is carried out by INSTALL.EXE. When this program has started, 
  125. a destination path has to be entered. If that path does not exist, it will be 
  126. created by the installation program. Then all files will be copied into the 
  127. specified directory. 
  128.  
  129. Since EClip exclusively consists of DLLs, the LIBPATH in the CONFIG.SYS has to 
  130. point to the installation path. If the installation path is not included in the 
  131. current LIBPATH, the installation program will add it automatically. 
  132.  
  133. Same for the HELP path and the dirctory in which the help file should be 
  134. placed. 
  135.  
  136. To have access to the external programs of Extended Clipboard/2 the 
  137. installation directory will be added to the PATH statements in the \CONFIG.SYS 
  138. and \AUTOEXEC.BAT. The original files will be saved as *.000 (if they already 
  139. exist as *.001 and so on.). 
  140.  
  141. Now the first part of the installation has been completed. The second part will 
  142. automatically start with the next system start: A new folder, called "Extended 
  143. Clipboard /2", will be placed on the desktop as well as new templates in the 
  144. templates folder for the new datatypes, EClip provides. Now the full 
  145. installation has been completed. 
  146.  
  147. Clips of an old EClip installation which were left on the desktop will be known 
  148. as clips after an additional system shutdown. Then they will have the extended 
  149. abilities such as Drag&Drop. 
  150.  
  151.  
  152. ΓòÉΓòÉΓòÉ 5. Usage ΓòÉΓòÉΓòÉ
  153.  
  154. As long as the EClip folder is closed, EClip remains without function: No 
  155. entries of the clipboard will be saved - the clipboard operates as usual. Only 
  156. if the EClip folder is open, every new entry in the clipboard will be stored 
  157. and saved in this folder. 
  158.  
  159. EClip takes care that there will not be any multiple clips with the same 
  160. content and title. 
  161.  
  162. Normally the last 'cut' or 'copied' data is the next to be inserted into an 
  163. application. By marking an entry in the EClip folder the next one to be 
  164. inserted can be chosen. 
  165.  
  166. Of course it is possible - as usual with OS/2 - to mark several entries with 
  167. the pressed mouse button 1. Other possibilities are: 
  168.  
  169. Pressing CTRL while marking clips allows to select various single clips. 
  170.  
  171. Holding SHIFT while clicking on an entry will mark several entries sequently, 
  172. pressing CTRL and mouse button 1 will select single entries without deselecting 
  173. other entries. 
  174.  
  175.  
  176. A text that has been saved in EClip can easily be inserted into almost any PM - 
  177. application by Drag&Drop. 
  178.  
  179. Autopaste allows half automatic insertion of Clips in PM - applications by 
  180. Hotkeys. 
  181.  
  182. External programs can be used to access the OS/2 clipboard from DOS and OS/2 
  183. shells. 
  184.  
  185.  
  186. ΓòÉΓòÉΓòÉ 5.1. External programs ΓòÉΓòÉΓòÉ
  187.  
  188. The following programs can be called from OS/2 shells as well as from DOS 
  189. shells: 
  190.  
  191.      TOCLIP.EXE can write text to the clipboard. Call: 
  192.  
  193.             TOCLIP [Filename]
  194.             TOCLIP < [Filename]
  195.             TYPE [Filename] | TOCLIP
  196.             ECHO This text to EClip | TOCLIP
  197.  
  198.      FROMCLIP.EXE reads text from the OS/2 clipboard and writes it to the 
  199.       divertable standard print-out (STDOUT). Call: 
  200.  
  201.             FROMCLIP > [Filename]
  202.             FROMCLIP | FIND "search text"
  203.  
  204.      The program OPEN.EXE opens any object on the desktop and can be used with 
  205.       or without EClip. For example it is possible to play a macro. Every 
  206.       object wich is accessable from the desktop can be opened: 
  207.  
  208.  
  209.             OPEN Objekt
  210.             OPEN System
  211.             OPEN C:\OS2\HELP
  212.             OPEN "System\Systemconfiguration\Hardware Manager"
  213.  
  214.  
  215. ΓòÉΓòÉΓòÉ 6. General Configuration ΓòÉΓòÉΓòÉ
  216.  
  217.  EClip can be configured on settings pages of the folder. (contextmenu is 
  218. accessable by pressing mouse button 2 over the icon of the EClip folder) There 
  219. will be the following additional settings pages: 
  220.  
  221.  
  222.  
  223.      EClip/View pag 1 of 2 
  224.      EClip/View page 2 of 2 
  225.      Clips page 1 of 2 (text) 
  226.      Clips page 2 of 2 (bitmaps) 
  227.      Hotkeys 
  228.  
  229.  
  230. ΓòÉΓòÉΓòÉ 6.1. EClip/View page 1 of 2 ΓòÉΓòÉΓòÉ
  231.  
  232.  
  233.  
  234. On this page general adjustments can be made: 
  235.  
  236.      Automatic deletion of old clips if there are more than a given number and 
  237.       / or the clips are older than a given number of days. The clips will be 
  238.       deleted if a new entry is created in the EClip folder or if the menu item 
  239.       'Refresh now' is chosen. 
  240.  
  241.       Single clips can be marked as not deleteable on the settings on single 
  242.       clips page. 
  243.  
  244.      At Cut sound: The WAV file that will be played if a new item is placed in 
  245.       EClip can be changed. 
  246.  
  247.      An Always-on-top button can be inserted in the EClip titlebar. With that 
  248.       button the EClip window can be made floating above all other windows 
  249.  
  250.      If the marked clip is a bitmap it can be displayed as the background 
  251.       picture of the EClip folder. 
  252.  
  253.      The Autopaste function can be switched on or off. 
  254.  
  255.      Should the EClip folder be opened 'minimized' 
  256.  
  257.  
  258. ΓòÉΓòÉΓòÉ 6.2. EClip/View page 2 of 2 ΓòÉΓòÉΓòÉ
  259.  
  260.  
  261.  
  262. On this settings page the (details) view of the EClip folder can be adjusted. 
  263. Different information on the clips can be chosen for display. 
  264.  
  265. For a detailed description please open the settingspage 'EClip/View Page 2 of 
  266. 2' of the EClip folder and press the help button. 
  267.  
  268.  
  269. ΓòÉΓòÉΓòÉ 6.3. Clips page 1 of 2 (text) ΓòÉΓòÉΓòÉ
  270.  
  271.  
  272.  
  273. On this page the default settings for newly created Clips of the type 'text' 
  274. can be specified. The adjustment of already existing clips is described at 
  275. Adjustments on single clips 
  276.  
  277.      Here can be chosen, if text that is copied to the clipboard should be 
  278.       stored in EClip. 
  279.  
  280.      Which method should be used to insert text clips per Drag&Drop or Hotkey 
  281.       into the destination application ? 
  282.  
  283.       Normally all PM-Applications which support the OS/2 Clipboard are 
  284.       supposed to work with the default mode Use Clipboard, in which the key 
  285.       combination Shift-Insert is simulated to insert the contents of the 
  286.       clipboard (here: the clip). 
  287.  
  288.       If it does not work, it might be helpful to give Simulate input a try. 
  289.       Here every single character will be sent to the application by simulating 
  290.       the pressing of these keys. This could cause complications, because it is 
  291.       theoretically possible to answer security questions this way 
  292.       automatically. Dataloss could be the consequence ! 
  293.  
  294.      Should it be possible to insert text by Drag&Drop into PM applications ? 
  295.       Drag&Drop can be forbidden or allowed generally for all clips. 
  296.  
  297.      Should the keyboard LEDs be animated during playback of a macro ? 
  298.  
  299.      Should the title of an entry be automatically adjusted to its content ? 
  300.  
  301.       The entries of the EClip folder are the names of single files. These 
  302.       files have - as any file - a content besides the name. The filename can 
  303.       automatically be produced in such a way that it represents the first eg. 
  304.       80 characters of the content. So it is guaranteed that an old entry of 
  305.       the clipboard can be recognized in the EClip folder by its title. 
  306.  
  307.       When an entry in the EClipfolder is edited, its title may differ from its 
  308.       content. 
  309.  
  310.       With this global setting it is possible to specify if the title of a 
  311.       newly created EClip entry should be automatically adjusted. It is also 
  312.       possible to specify the maximal length of the generated title.  These 
  313.       adjustements can be made seperately for every single item. (see 
  314.       Adjustments on single entries). 
  315.  
  316.       Note: 
  317.       In general the title of a clip is generated from the first characters of 
  318.       its content. Exceptions: 
  319.  
  320.         -  if the fist character is '#' or '!' it will be replaced by '@' 
  321.         -  linefeed will be marked by  '#' 
  322.         -  '{}' will be replaced by '[]' 
  323.  
  324.      At 'Default types' the WPS datatype of textclips can be chosen. The 
  325.       preset type is 'Plain Text'. 
  326.  
  327.  
  328. ΓòÉΓòÉΓòÉ 6.4. Clips page 2 of 2 (Bitmaps) ΓòÉΓòÉΓòÉ
  329.  
  330.  
  331.  
  332. On this page the default settings for newly created Clips of the type 'bitmap' 
  333. can be specified. The adjustment of already existing clips is described at 
  334. Adjustments on single clips 
  335.  
  336. Here can be chose, if bitmaps which are copied to the clipboard should be 
  337. stored in EClip. 
  338.  
  339. At 'Default types' the WPS datatype of textclips can be chosen. The preset type 
  340. is 'Bitmap'. 
  341.  
  342.  
  343. ΓòÉΓòÉΓòÉ 6.5. Hotkeys ΓòÉΓòÉΓòÉ
  344.  
  345. On this page it is possible to choose if Hotkeys, which are assigned to macro 
  346. and text clips at the Adjustments on single clips, should be activated. 
  347.  
  348. Besides there is a list of clips that are currently assigned to hotkeys. 
  349.  
  350. By pushing the Update button this list can be updated in special cases. 
  351.  
  352. A double click on an entry will open the settings of this text clip. 
  353.  
  354.  
  355. ΓòÉΓòÉΓòÉ <hidden> TextClip Objekt ΓòÉΓòÉΓòÉ
  356.  
  357. A text clip is a data object provided by Extended Clipboard/2. 
  358.  
  359. In text clips old contents of the OS/2 clipboard will be stored. These Clips 
  360. can be configured at their context menu. (mouse button 2/Settings) 
  361.  
  362.  
  363. ΓòÉΓòÉΓòÉ <hidden> BitmapClip Objekt ΓòÉΓòÉΓòÉ
  364.  
  365. A bitmap clip is an data object, that is provided by Extended Clipboard/2. 
  366.  
  367. In these bitmap clips old bitmap contents of the OS/2 clipboard are stores. 
  368. These clips, get configured by opening their context menu (mouse button 2) / 
  369. Settings. 
  370.  
  371.  
  372. ΓòÉΓòÉΓòÉ 7. Adjustments on single clips ΓòÉΓòÉΓòÉ
  373.  
  374. Every clip in the EClip folder has its own context menu. The available options 
  375. on this page depend on the datatype (text, bitmap). In contrast to the 
  376. adjustments made in 'General configuration' clips can be configured 
  377. individually here. 
  378.  
  379. The settings pages depend on the clip type as well. 
  380.  
  381.  
  382.  
  383.      Settings on text clips 
  384.      Settings on bitmap clips 
  385.  
  386.  
  387. ΓòÉΓòÉΓòÉ 7.1. Adjustments on already existing text clips ΓòÉΓòÉΓòÉ
  388.  
  389. On this page adjustments for already existing text clips can be made. The 
  390. settings used to create new clips can be adjusted at General Configuration. 
  391.  
  392.      Should the title be automatically synchronized to the content ? 
  393.       The entries of the EClip folder are the names of single files. These 
  394.       files have - as any file-  besides the name also a content. The filename 
  395.       can automatically be produced in such a way  that it represents the first 
  396.       eg. 80 characters of the content. So it is guaranteed that an old entry 
  397.       of the clipboard can be recognized in the EClip folder by its title. 
  398.  
  399.       On the other hand it might be useful to name a clip different to its 
  400.       content. 
  401.  
  402.       This option is also accessible at the context menu of the clips 
  403.       ('Autosync title'). 
  404.  
  405.       The maximum length of the automatically generated title can be limited 
  406.       here as well. 
  407.  
  408.      Should it be possible to activate the clip by a chosen hotkey ? 
  409.  
  410.       If the hotkey is pressed together with all marked control keys (shift, 
  411.       ctrl and alt), the content of the clip will be inserted into the active 
  412.       application. Is the clip defined as a macro, the macro will be executed. 
  413.  
  414.      Default open action: What should happen if the clip is double clicked ? 
  415.  
  416.       There are three options: 
  417.  
  418.         -  The assignable standard application (normally the system editor) 
  419.            will be opened. 
  420.  
  421.         -  The content of the clip will be copied into the clipboard and 
  422.            availabe to all applications. 
  423.            This function can also be achieved by using the 'Copy to clipboard' 
  424.            method in the context menu of the clip. 
  425.  
  426.         -  If the clip is definded as a macro, this macro can be executed. 
  427.  
  428.      Should this clip not be deleted automatically under the conditions 
  429.       defined at EClip/View page 1 of 2 ? 
  430.  
  431.       This option is also available at the context menu of the clip. ('Don't 
  432.       delete') 
  433.  
  434.      This clip is an macro and contains executable macro commands. 
  435.  
  436.  
  437. ΓòÉΓòÉΓòÉ 7.2. Adjustments on already existing bitmap clips ΓòÉΓòÉΓòÉ
  438.  
  439. On this page adjustments for already existing bitmap clips can be made. The 
  440. settings used to create new clips can be adjusted at Clips page 2 of 2 
  441. (bitmaps) 
  442.  
  443.      Default open action: What should happen if the clip gets double clicked ? 
  444.       There are two choices: 
  445.  
  446.         -  The assignable standard application (normally the system editor) 
  447.            will be opened. 
  448.         -  The content of the clip will be copied to the clipboard and be 
  449.            availabe to all applications. 
  450.            This behaviour can be achieved also by using the 'Copy to clipboard' 
  451.            method in the context menu of the clip. 
  452.  
  453.      Should this clip not be deleted automatically, under the conditions 
  454.       defined at EClip/View page 1 of 2 ? 
  455.  
  456.       This option is also available at the context menu of the clip. ('Don't 
  457.       delete') 
  458.  
  459.  
  460. ΓòÉΓòÉΓòÉ <hidden> context menu 'Copy to Clipboard' ΓòÉΓòÉΓòÉ
  461.  
  462.  
  463. The content of this clip will be copied to the clipboard and then is available 
  464. to all applications. 
  465.  
  466. The clip can be configured on its settings page (context menu -> mouse button 
  467. 2/Settings) to do the same copying if it is double clicked. 
  468.  
  469.  
  470. ΓòÉΓòÉΓòÉ <hidden> Kontextmen╨æ 'Record macro' ΓòÉΓòÉΓòÉ
  471.  
  472.  
  473. The in Extended Clipboard/2 integrated macro recorder, will be started. 
  474.  
  475.  
  476. ΓòÉΓòÉΓòÉ <hidden> Kontextmen╨æ 'Play macro' ΓòÉΓòÉΓòÉ
  477.  
  478.  
  479. If this clip is marked as a macro, it will be played. 
  480.  
  481.  
  482. ΓòÉΓòÉΓòÉ <hidden> Kontextmen╨æ 'Autosync title' ΓòÉΓòÉΓòÉ
  483.  
  484.  
  485. If this option is checked, the title will be synchronized with the content of 
  486. this clip, if it is changed, eg. by an editor. 
  487.  
  488. This setting is also availalbe on the settings page (mouse button 2/Settings) 
  489. of this clip. 
  490.  
  491.  
  492. ΓòÉΓòÉΓòÉ <hidden> Kontextmen╨æ 'Don't delete' ΓòÉΓòÉΓòÉ
  493.  
  494.  
  495. This clip will not be deleted under the conditions defined at EClip/View page 1 
  496. of 2 
  497.  
  498. This setting is also availalbe on the settings page (mouse button 2/Settings) 
  499. of this clip. 
  500.  
  501.  
  502. ΓòÉΓòÉΓòÉ 8. Preset hotkeys ΓòÉΓòÉΓòÉ
  503.  
  504.  
  505. These hotkeys are preset: 
  506.  
  507.      Right shift: Stop an active macro. Keys possibly pressed by the macro 
  508.       (shift, alt, mouse) will not be restored and could remain in the pressed 
  509.       state ! 
  510.  
  511.      Ctrl-Alt-Cursor Up: and 
  512.       Ctrl-Alt-Cursor Down: Autopaste. 
  513.  
  514.      Ctrl-Tab-Cursor Up and 
  515.       Ctrl-Tab-Cursor Down: Selection of the next clip in the EClip folder (and 
  516.       copying it to the clipboard) without insertion into the active 
  517.       application. This function is similar to an uncompleted Autopaste. 
  518.  
  519.      Shift-Ctrl-Tab-Cursor Up and 
  520.       Shift-Ctrl-Tab-Cursor Down: The next clip in the EClip folder will be 
  521.       selected additionally to the already selected clips (and added to the 
  522.       clipboard). In contrast to Autopaste the clipboard will not be inserted 
  523.       into the active application. 
  524.  
  525.  
  526. ΓòÉΓòÉΓòÉ 9. The macro recorder ΓòÉΓòÉΓòÉ
  527.  
  528.  
  529.  
  530. The macro recorder is used to record macros. The recorder is activated by 
  531. opening the context menu of a text clip and selecting the option 'Record 
  532. Macro'. A window to configure the following options will pop up: 
  533.  
  534.      Record mouse movement selects if all mouse movements should be recorded 
  535.       additionally to keys and mouse buttons. 
  536.       Note: The actual position of the mouse pointer will be recorded at the 
  537.       start of recording but it will be disabled. If the mouse pointer should 
  538.       be placed at the same position with every macro playback, the macro has 
  539.       to be edited with a text editor after recording. The ';' in front of the 
  540.       first PTRPOS command has to be removed. Otherwise all mouse commands will 
  541.       be executed relatively to the position of the mouse pointer when the 
  542.       playback is started. 
  543.  
  544.      Original timing selects if the macro should be played with exactly the 
  545.       same delays as recorded. If this option is deselected the playback will 
  546.       always be at highest speed - without any delays. 
  547.  
  548.       That might have the consequence that some windows that are to receive 
  549.       keyboard input are not available at the moment of playback. The keyboard 
  550.       input might reach a wrong window which will cause unexpected actions. 
  551.  
  552.  
  553.  After leaving this window by pushing 'OK', the recording of macro will be 
  554.  started by pressing the key 'Scroll' or 'Scrollock'. As an confirmation the 
  555.  scroll lock LED on the keyboard will start flashing. The recorded macro 
  556.  commands will be added to the end of the existing text clip. The recording can 
  557.  be stopped by pressing the 'Scrollock' key again. 
  558.  
  559.  The macro can be played either by pressing the hotkey, defined on the settings 
  560.  page of the macro clip, the option 'Play Macro' on the same page or the menu 
  561.  'Play Macro' in the context menu. 
  562.  
  563.  
  564. ΓòÉΓòÉΓòÉ 9.1. The macro language ΓòÉΓòÉΓòÉ
  565.  
  566.  
  567.  
  568. Macros can be created without the macro recorder, too. A text editor can be 
  569. used to create or work over an existing macro. Normally the system editor can 
  570. be opened by double clicking the clip. 
  571.  
  572. To be recognized as a macro, the option 'Macro' has to be set on the Settings 
  573. of the text clip page. The macro recorder sets this option on his own to make 
  574. the clip a macro clip. 
  575.  
  576. EClip knows the following commands: 
  577.  
  578.      <key+>             : presses the key together with the next one. Eg. 
  579.                            <ALT+><CTRL+>a 
  580.      <key-D>            : Holds the key down (z.B. <ALT-D> <a-D>) 
  581.      <Taste-U>          : Releases the key (z.B.<ALT-U> <a-U>) 
  582.      'Normal' characters : either in <> or without <>. Eg. "a" = "<a>" 
  583.                            Exception: "<<>": "<" has to be placed in pointed 
  584.                            brackets. 
  585.      <END>              : The key "End" 
  586.      <HOME>             : The key "Home" 
  587.      <PGDN>             : The key "Page down" 
  588.      <PGUP>             : The key "Page up" 
  589.      <INS>              : The key "Insert" 
  590.      <DEL>              : The key "Delete" 
  591.      <TAB>              : The key "TAB" 
  592.      <SHIFT>            : The key "Shift" 
  593.      <ALT>              : The key "Alt" 
  594.      <CTRL>             : The key "Ctrl" 
  595.      <BACK>             : The key "Backspace" 
  596.      <ESC>              : The key "Esc" 
  597.      <F1>...<F12>       : The function keys 
  598.      <UP>               : The key "Up" 
  599.      <DOWN>             : The key "Down" 
  600.      <LEFT>             : The key "Left" 
  601.      <RIGHT>            : The key "Right" 
  602.      <PAUSE>            : The key "Pause" 
  603.      <PRINTSCREEN>      : The key "Print" 
  604.      <NUMLOCK>          : The key "Num" 
  605.      <CAPSLOCK>         : The key "Capslock" 
  606.      <DELAY:x>          : Before the execution of the next macro command there 
  607.                            will be a delay of x ms. This setting can be 
  608.                            overridden for single commands. 
  609.      <PTRPOS:x,y>       : Absolute position of the mouse pointer 
  610.      <PTRMV:x,y>        : Movement of the mouse pointer by pixels 
  611.      <PTR-BL>           : Place the pointer in the bottom, right corner of the 
  612.                            active window 
  613.      <PTR-BR>           : Place the pointer in the bottom, left corner of the 
  614.                            active window 
  615.      <PTR-TL>           : Place the pointer in the top, left corner of the 
  616.                            active window 
  617.      <PTR-TR>           : Place the pointer in the top, right corner of the 
  618.                            active window 
  619.      <BUTTON1>          : mouse click with mouse button 1 
  620.      <BUTTON1-D>        : Hold mouse button 1 down 
  621.      <BUTTON1-U>        : Release mouse button 1 
  622.      <BUTTON1DBL>       : mouse button 1 double click 
  623.      <BUTTON2>          : mouse click with mouse button 2 (all <BUTTON1> 
  624.                            commands apply to <BUTTON2> as well) 
  625.      <BUTTON3>          : mouse click with mouse button 3 (all <BUTTON1> 
  626.                            commands apply to <BUTTON3> as well) 
  627.      <;comment>         : comment 
  628.      <>                 : Ignore the rest of the line 
  629.      <REPEAT:x>         : Repeat all commands from here to <REPEND> x times 
  630.                            (multiple loops can be placed in another) 
  631.      <REPEND>           : End of loop 
  632.  
  633.  
  634.  Note: 
  635.  The execution of macro commands can be delayed. 
  636.  
  637.  
  638. ΓòÉΓòÉΓòÉ 9.2. Macro / hotkey example ΓòÉΓòÉΓòÉ
  639.  
  640. The following macro and its assignment to a hotkey should give an example of 
  641. how to use macros and hotkeys. 
  642.  
  643.      You Drag&Drop a macro from the macro template in the template folder to 
  644.       the desktop. 
  645.  
  646.      Open the context menu with mouse button 2 of the new macro clip and 
  647.       choose Record macro. 
  648.  
  649.      Depending on the area of application the actions to be recorded can be 
  650.       chosen. This example does not need any special commands to be recorded - 
  651.       all options can be deselected. Leave the window by pushing 'OK'. 
  652.  
  653.      You start the recording of the maco by pressing the 'Scroll' or 'Scroll 
  654.       Lock' key. The corresponding LED on the keyboard starts to flash. All 
  655.       keys pressed from now on will be recorded. 
  656.  
  657.      In this example we press the following sequence of keys Shift-insert : 
  658.  
  659.         -  Hold down the shift key 
  660.         -  press and release 'Ins' 
  661.         -  release shift key 
  662.  
  663.      The recording can be stopped now by pressing the 'Scroll' or 'Scoll lock' 
  664.       key again. The corresponding LED on the keyboard stops to flash. 
  665.  
  666.      A double click on the new macro opens the system editor and shows the 
  667.       macro that has just been recorded: <SHIFT-DN><INS><SHIFT-UP> are excacty 
  668.       the keys which were pressed while recording. If there is a need, there 
  669.       can be new macro commands added or existing commands modified. In this 
  670.       special case the following macro would habe been aquivalent: 
  671.       <SHIFT+><INS> It offers the same function. 
  672.  
  673.      After closing the editor the macro can be played by choosing 'Play macro' 
  674.       in the context menu of the clip or by pushing a hotkey. Use mouse button 
  675.       2/Settings to get to the settings page of this object. You can 
  676.  
  677.         -  activate and choose a hotkey. We choose the key combination 
  678.            'ctrl-BUTTON2DBL'. 
  679.         -  choose if a double click on the icon of this macro should play the 
  680.            macro instead of opening the system editor. That doesn't make much 
  681.            sense for our example. 
  682.  
  683.  
  684.  A double click of mouse button 2 in the system editor with the ctrl key 
  685.  pressed will insert the content of the clipboard to the current cursor 
  686.  position. That's because the key combination 'ctrl-ins' normally inserts the 
  687.  content of the clipboard. This is also valid for many other applications. 
  688.  
  689.  
  690. ΓòÉΓòÉΓòÉ 10. Known problems ΓòÉΓòÉΓòÉ
  691.  
  692. There might be a few problems while using EClip : 
  693.  
  694.      The clipboard viewer included in OS/2 does not operate correctly 
  695.  
  696.      Clip suddenly disappears 
  697.  
  698.      EClip folder closes automatically 
  699.  
  700.      Window order is mixed up 
  701.  
  702.      Programs, wich cannot be used together with EClip 
  703.  
  704.      Other data types but bitmap and text 
  705.  
  706.  
  707. ΓòÉΓòÉΓòÉ 10.1. The clipboard viewer included in OS/2 does not operate correctly ΓòÉΓòÉΓòÉ
  708.  
  709. The 'clipboard viewer' does not cooperate with clipboard extensions like EClip. 
  710. As soon as the 'clipboard viewer' has been used to view the contents of the 
  711. clipboard with EClip opened, EClip will not get any more notification if the 
  712. contents of the clipboard change. That's why EClip cannot create new clips in 
  713. this case. 
  714.  
  715. To make EClip operate again just close and reopen the EClip folder. 
  716.  
  717. The clipboard viewer and EClip can only be used together if the clipboard 
  718. viewer is started first, and EClip is opened afterwards. 
  719.  
  720.  
  721. ΓòÉΓòÉΓòÉ 10.2. Clip suddenly disappears ΓòÉΓòÉΓòÉ
  722.  
  723. In Warp V4 dragging an object to the desktop will create a shadow of the object 
  724. by default. 
  725.  
  726. So, if the original object in the EClip folder gets deleted, the shadow will be 
  727. deleted, too. That might by confusing since clips may be deleted automatically. 
  728. (see  EClip/View page 2 of 2) 
  729.  
  730. A solution would be to set the 'Don't delete' flag for this entry. (see 
  731. Settings on existing clips). 
  732.  
  733. Of cause it is possible not to create a shadow but a copy of the entry (ctrl - 
  734. mouse button 2) or to move the entry to the Desktop (shift - mouse button 2). 
  735. This will make these problems not occur. 
  736.  
  737.  
  738. ΓòÉΓòÉΓòÉ 10.3. EClip folder closes automatically ΓòÉΓòÉΓòÉ
  739.  
  740. It is possible to adjust Warp 4 in such a way, that with opening an object, the 
  741. folder, in which the object is placed, gets closed automatically. If this 
  742. adjustment is made for the whole system (system configuration /System/Window/2 
  743. : All objects) it will be also valid for the EClip folder. 
  744.  
  745. As a consequence the EClip folder gets closed automatically after a double 
  746. click on a clip. With the EClip folder closed, no new contents of the clipboard 
  747. will be stored. 
  748.  
  749. Solution: Choose 'Never' on the the settings page of the EClip folder  ('Window 
  750. page 2 of 2'). 
  751.  
  752.  
  753. ΓòÉΓòÉΓòÉ 10.4. Window order is mixed up ΓòÉΓòÉΓòÉ
  754.  
  755. If the EClip folder is set to be displayed permanently on top by the 
  756. 'Always-on-top framebutton', faults in the order of WINOS/2 windows on the OS/2 
  757. desktop can occur. 
  758.  
  759.  
  760. ΓòÉΓòÉΓòÉ 10.5. Programs, that cannot be used together with EClip ΓòÉΓòÉΓòÉ
  761.  
  762.      The program ManyClip by Tim Francis cannot be used together with EClip. 
  763.  
  764.  
  765. ΓòÉΓòÉΓòÉ 10.6. Other data types but bitmap and text ΓòÉΓòÉΓòÉ
  766.  
  767. EClip currently supports clips of the types 'bitmap' and 'text'. It would be 
  768. possible to support other clipboard formats. If there is a demand, please let 
  769. the author know. 
  770.  
  771.  
  772. ΓòÉΓòÉΓòÉ 11. Uninstallation ΓòÉΓòÉΓòÉ
  773.  
  774.  
  775.  
  776. EClip can be uninstalled by UNINST.EXE It will remove all classes that have 
  777. been by registered by EClip and all EClip entries in the INI files as well as 
  778. the newly created templates. 
  779.  
  780. The installation path will not be deleted. Changes made to \CONFIG.SYS and 
  781. \AUTOEXEC.BAT will be removed. 
  782.  
  783. Only after a system reboot it is possible to delete the installation path and / 
  784. or to install a new version of EClip. 
  785.  
  786. To update EClip from V1.x to V2.x the old installation path has to be deleted 
  787. manually from your config.sys before the installation of the new version ! 
  788.  
  789.  
  790. ΓòÉΓòÉΓòÉ 12. Closing words ΓòÉΓòÉΓòÉ
  791.  
  792. The author can be reached at: 
  793.  
  794.         HBecker@bigfoot.com 
  795.  
  796.  or via snailmail: 
  797.  
  798.         Hinnerk Becker 
  799.         Kortenwisch 5c 
  800.         22397 Hamburg 
  801.         Germany 
  802.  
  803.  I would like to express my thanks to Bernd Troszynski for many helpful 
  804.  suggestions, tips and the writing of this documentation. 
  805.  
  806.  Hinnerk Becker, November 1997 
  807.  
  808.  
  809. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  810.  
  811.  
  812. Hold down mouse button 2 to drag an object and release the mouse button over 
  813. the destination application to drop it. 
  814.  
  815.  
  816. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  817.  
  818.  
  819. An object in wich a single (old) clipboard content or a macro is stored is 
  820. called clip 
  821.  
  822.  
  823. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  824.  
  825.  
  826. EClip is used in this documentation as a short term for Extended Clipboard/2. 
  827.  
  828.  
  829. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  830.  
  831.  
  832. What are 'default types' ? 
  833.  
  834. Normally every data file is assigned to a type which is stored in its extended 
  835. attributes. In most cases there is at least one program, wich is able to work 
  836. on data of this type and therefore is assigned to that type. For the type 
  837. 'Plain Text' this is the editor 'E' by default. The association 'Plain Text' - 
  838. 'E' can be changend system wide in the settings of the system editor. 
  839.  
  840. Instead of giving the data type 'Plain Text' to a new clip, it is also possible 
  841. to create a new data type. This new data type has to be added to the WPS type 
  842. list. This can be done on the association settings page of any program object. 
  843. The assignment of the new data type is done on this page, too. A double click 
  844. on the clip will start this application from now on. 
  845.  
  846. Of course the same works for the type 'Bitmap' and the Bitmap viewer. If the 
  847. symbol editor is also assigned to this type you can choose in the context menu 
  848. / open wich program to use on the data. 
  849.  
  850. It is possible to enter multiple types at 'Default types'. They have to be 
  851. separated by ','. Superfluous blanks have to be avoided. For example 'Plain 
  852. Text,TextClip' would add all applications associated with these types to the 
  853. context menu (mouse button 2/open) of the new clips. 
  854.  
  855.  
  856. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  857.  
  858.  
  859. A text clip with the macro option set on its settings page is is called a macro 
  860.  
  861. A macro can simulate keyboard and mouse events. Macros can be recorded with the 
  862. macro recorder, intergrated in EClip, and / or edited with any text editor. 
  863.  
  864.  
  865. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  866.  
  867.  
  868. Usually a hotkey is a combination of multiple keys pressed simultaneously. 
  869. But it is also possible to define a single key as a hotkey. Even mouse buttons 
  870. can be hotkeys. 
  871. You can assign a text clip to a hotkey on its settings page. If the hotkey gets 
  872. pressed, the action of the clip will be performed. 
  873.  
  874. This can be the insertion of its content into the active application or the 
  875. execution of a macro. 
  876.  
  877. Some hotkeys are predefined by EClip. 
  878.  
  879.  
  880. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  881.  
  882.  
  883. Autopaste allows to insert clips semi automatically into PM applications by 
  884. hotkeys without having to switch to the EClip folder to select the next clip. 
  885.  
  886. After a clip has been inserted, the next clip in the EClip folder gets selected 
  887. and is copied to the clipboard to let the next Autopaste action insert just 
  888. this (the next) clip. So several old clipboard entries can be placed in the 
  889. application one after the other. 
  890.  
  891. The hotkeys are 
  892. Ctrl-Alt-Cursor Up and 
  893. Ctrl-Alt-Cursor Down. 
  894.  
  895. There is also the possibility of selecting another clip without inserting it 
  896. into the application - like an uncompleted Autopaste action. The Hotkeys are 
  897. Ctrl-Alt-AltGr-Cursor Up and 
  898. Ctrl-Alt-AltGr-Cursor Down. 
  899.  
  900.  
  901. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  902.  
  903.  
  904. The 'mouse buttons' 
  905.  
  906. If the mouse is configured for right-handed persons, 
  907.  
  908.      the left button is called 'mouse button 1' 
  909.      the right button is called 'mouse button 2' 
  910.      an possibly existing middle button is called 'mouse button 3' 
  911.  
  912.  If the mouse is configured for left-handed persons, mouse buttons 1 and 2 are 
  913.  swapped. 
  914.  
  915.  
  916. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  917.  
  918.  
  919. A number can precede every macro command. This number is the time in 
  920. milliseconds to wait before the command is executed. The command 
  921.  
  922.      <100HOME> 
  923.  
  924.  waits for a tenth of a second and then simulates the pressing of the 'home' 
  925.  key. 
  926.  
  927.  All other following commands will be executed with the delay defined by the 
  928.  <DELAY:x> command.