home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / OS2 / TWCP132.ZIP / TWCP.HLP (.txt) < prev    next >
OS/2 Help File  |  1994-03-27  |  23KB  |  313 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Copyright ΓòÉΓòÉΓòÉ
  3.  
  4. TWCP  V 1.32 - Text Window Cut and Paste 
  5.  
  6. Copyright 1994 by Masar Software Ltd. 
  7. All rights reserved. 
  8.  
  9. This is free software. 
  10.  
  11. If you find this program useful, let me know, 
  12. send a postcard with a photo of your city to: 
  13.  
  14.           Maurizio Sartori Masar
  15.           Via MonteGrappa  7
  16.           20044 Bernareggio
  17.              (Milano)  ITALY
  18.  
  19.  Commercial distribution and/or use is prohibited without written consent by 
  20.  the author. 
  21.  
  22.  Because the program is licensed free of charge, there is no warranty for the 
  23.  program, to the extent permitted by applicable law. 
  24.  Except when otherwise stated in writing the copyright holders and/or other 
  25.  parties provide the program "as is" without warranty of any kind, either 
  26.  expressed or implied, including, but not limited to, the implied warranties of 
  27.  merchantability and fitness for a particular purpose. 
  28.  The entire risk as to the quality and performance of the program is with you. 
  29.  Should the program prove defective, you assume the cost of all necessary 
  30.  servicing, repair or correction. 
  31.  
  32.  In no event unless required by applicable law or agreed to in writing will any 
  33.  copyright holder, or any other party who may modify and/or redistribute the 
  34.  program as permitted above, be liable to you for damages, including any 
  35.  general, special, incidental or consequential damages arising out of the use 
  36.  or inability to use the program (including but not limited to loss of data or 
  37.  data being rendered inaccurate or losses sustained by you or third parties or 
  38.  a failure of the program to operate with any other programs), even if such 
  39.  holder or other party has been advised of the possibility of such damages. 
  40.  
  41.  
  42. ΓòÉΓòÉΓòÉ 2. About TWCP ΓòÉΓòÉΓòÉ
  43.  
  44. TWCP  V 1.32 - Text Window Cut and Paste 
  45.  
  46. The TWCP application is a simple Presentation Manager application which let you 
  47. Mark, Copy and Paste text and graphics from a DOS or OS/2 Window using the 
  48. mouse, like in X Windows, without passing through the system menu. 
  49.  
  50.  
  51. ΓòÉΓòÉΓòÉ 3. History ΓòÉΓòÉΓòÉ
  52.  
  53. Version 1.00 
  54.  
  55.      o Initial release. 
  56.  
  57.  Version 1.10 
  58.  
  59.      o Added option to eliminate last Carriage Return. 
  60.  
  61.  Version 1.20 
  62.  
  63.      o Rewritten Hook procedure. 
  64.      o Corrected problem with buttons 2 and 3 in mark operations. 
  65.      o Corrected problem with Disable button. 
  66.      o Corrected minor bugs. 
  67.      o Minor changes to documentation (added notes and warning). 
  68.      o Forced use of control key(s) if Button 1 is used for mark. 
  69.  
  70.  Version 1.30 
  71.  
  72.      o Added option to copy and paste in entry fields. 
  73.      o Added option "/L" to lower a window z-order clicking on its title. 
  74.      o Minor esthetical changes 
  75.  
  76.  Version 1.31 
  77.  
  78.      o Corrected problem with minimized icon drawing. 
  79.      o Corrected problem with errors in command line parameters. 
  80.  
  81.  Version 1.32 
  82.  
  83.      o Corrected problem with "/L" option 
  84.      o Enhanced "/L" option to allow use of any combination of mouse button and 
  85.        Shift, Alt and Ctrl keys. 
  86.  
  87.  
  88. ΓòÉΓòÉΓòÉ 4. Known Bugs ΓòÉΓòÉΓòÉ
  89.  
  90. With OS/2 V 2.11 the TWCP can only be Minimized to Viewer, this is a problem of 
  91. the Service Pack :-(, with other versions of OS/2 you can Hide, Minimize to 
  92. Viewer or to Desktop as usual. 
  93.  
  94.  
  95. ΓòÉΓòÉΓòÉ 5. Masar Software Ltd ΓòÉΓòÉΓòÉ
  96.  
  97. Masar Software Ltd. 
  98.  
  99. For bugs or suggestions, please write to: 
  100.  
  101.           Maurizio Sartori Masar
  102.           Via MonteGrappa  7
  103.           20044 Bernareggio
  104.              (Milano)  ITALY
  105.  
  106.  or email to the INTERNET address: 
  107.  
  108.      masar@cdc8g5.cdc.polimi.it 
  109.      masar@131.175.6.1 
  110.  
  111.  Acknowledgments 
  112.  
  113.  Thanks to Simona who helped me in writing the documentation. 
  114.  
  115.  
  116. ΓòÉΓòÉΓòÉ 6. Install ΓòÉΓòÉΓòÉ
  117.  
  118. In this package, you should receive these files: 
  119.  
  120. Γûá TWCP.EXE      -  Program file
  121. Γûá TWCPHOOK.DLL  -  Program hook library
  122. Γûá TWCP.HLP      -  Program help file
  123. Γûá READ.ME       -  Program description in ASCII format.
  124.  
  125.  To install TWCP copy TWCP.EXE in a directory in your PATH, TWCPHOOK.DLL in a 
  126.  directory in your LIBPATH and TWCP.HLP in a directory in your HELP path. 
  127.  
  128.  That is all, now you can use TWCP. 
  129.  
  130.  
  131. ΓòÉΓòÉΓòÉ 7. Command Line Syntax and Options ΓòÉΓòÉΓòÉ
  132.  
  133. TWCP has the following syntax: 
  134.  
  135.      TWCP [/? | /H] [/L[1,2,3,A,S,C]] 
  136.  
  137.  Where 
  138.  
  139.  /? /H     Print this help. 
  140.  /L        Enable Low It option 
  141.  
  142.  
  143. ΓòÉΓòÉΓòÉ 7.1. Low It Option ΓòÉΓòÉΓòÉ
  144.  
  145. This option is enabled with the /L[opt] switch in the command line. 
  146.  
  147. When this option is enabled you can low a window, putting it below all windows, 
  148. clicking with Button 2 on its Title Bar. 
  149.  
  150. You can use the following modifiers to the option: 
  151.  
  152.  1         Use mouse button 1. 
  153.  2         Use mouse button 2 (default). 
  154.  3         Use mouse button 3. 
  155.  C         Use CTRL key with mouse. 
  156.  A         Use ALT key with mouse. 
  157.  S         Use SHIFT key with mouse. 
  158.  
  159.  Note:  /L1 isn't a valid option! 
  160.  
  161.  sample:  TWCP /L3AC will enable the option using button 3 with ALT and CTRL 
  162.  keys. 
  163.  
  164.  Warning: When this option is enabled, applications' title bar will not see the 
  165.  button click: if a pop up menu is associated with a click of the button on the 
  166.  title bar, it will never be activated. 
  167.  
  168.  Note:  This option is not saved with the program profile, it must be specified 
  169.  every time TWCP is executed to have effect. 
  170.  
  171.  
  172. ΓòÉΓòÉΓòÉ 8. Using ΓòÉΓòÉΓòÉ
  173.  
  174. This section explain how to use TWCP. 
  175.  
  176.  
  177. ΓòÉΓòÉΓòÉ 8.1. Enabling ΓòÉΓòÉΓòÉ
  178.  
  179. To enable TWCP you should: 
  180.  
  181.   1. Select the mouse button with which you want to Mark and Copy, checking the 
  182.      corresponding radio button. 
  183.   2. Chose which control key(s) (Shift, Alt, Ctrl) you would like to use 
  184.      together with the mouse to Mark and Copy, checking the corresponding check 
  185.      button. 
  186.   3. Select the mouse button with which you want to Paste checking the 
  187.      corresponding radio button. 
  188.   4. Chose which control key(s) (Shift, Alt, Ctrl) you would like to use 
  189.      together with the mouse to Paste, checking the corresponding check button. 
  190.   5. Enable TWCP clicking on the ENABLE button. 
  191.  
  192.  Now you can start to use TWCP. 
  193.  
  194.  
  195. ΓòÉΓòÉΓòÉ 8.2. Disabling ΓòÉΓòÉΓòÉ
  196.  
  197. To Disable TWCP you should click on the DISABLE button. 
  198.  
  199.  
  200. ΓòÉΓòÉΓòÉ 8.3. Marking and Copying ΓòÉΓòÉΓòÉ
  201.  
  202. To Mark and Copy a portion of text in a DOS or OS/2 Text window you should do 
  203. the following: 
  204.  
  205.   1. Press the Mark and Copy control key(s). 
  206.   2. Click the Mark and Copy mouse button where you want to start marking. 
  207.   3. Drag the mouse, holding down button and key, till the end of the portion 
  208.      of text you want to mark. Now the zone should be highlighted. 
  209.   4. Release the Mark and Copy mouse button. 
  210.   5. Release the Mark and Copy key. 
  211.  
  212.  The text or graphics you marked is automatically copied to the Clipboard. 
  213.  
  214.  Note:  If you release the control key(s) before releasing the mouse button, 
  215.  you remain in mark mode. To complete the operation, restart from point 1. 
  216.  
  217.  
  218. ΓòÉΓòÉΓòÉ 8.4. Pasting ΓòÉΓòÉΓòÉ
  219.  
  220. To Paste from the Clipboard you should do the following: 
  221.  
  222.   1. Press the Paste control key(s). 
  223.   2. Click the Paste mouse button in the window in which you want to paste. 
  224.   3. Release the Paste mouse button. 
  225.   4. Release the Paste key. 
  226.  
  227.  The text or graphics is automatically pasted to the window. 
  228.  
  229.  Warning: You should hold down the control key(s) till the paste operation is 
  230.  completed, otherwise the text program could loose the release of the control 
  231.  key(s). 
  232.  
  233.  
  234. ΓòÉΓòÉΓòÉ 9. How it works ΓòÉΓòÉΓòÉ
  235.  
  236. TWCP works installing a system hook that intercepts every mouse message posted. 
  237. If the message is directed to a DOS or OS/2 Text Window, that has a window 
  238. class of type Shield, or to a Entry Field, #6 and #10 classes, and it is a 
  239. Mark, Copy or Paste key combination, the messages for Mark, Copy or Paste are 
  240. send to the window. 
  241.  
  242. Warning: Because the program relies on the class name, and there can be other 
  243. windows with class name Shield that aren't DOS or OS/2 Text Windows, the 
  244. program can fail with those windows. 
  245. The fields Class and Parent show the class name of every window in which the 
  246. mouse is clicked. 
  247. If you find a program that makes fail TWCP please let me know. 
  248.  
  249.  
  250. ΓòÉΓòÉΓòÉ 10. Mark and Copy Buttons ΓòÉΓòÉΓòÉ
  251.  
  252. Use these buttons to select which mouse button and control key(s) you want to 
  253. use for Mark and Copy operations. 
  254.  
  255.  
  256. ΓòÉΓòÉΓòÉ 11. Paste Buttons ΓòÉΓòÉΓòÉ
  257.  
  258. Use these buttons to select which mouse button and control key(s) you want to 
  259. use for Paste operations. 
  260.  
  261.  
  262. ΓòÉΓòÉΓòÉ 12. Enable / Disable Button ΓòÉΓòÉΓòÉ
  263.  
  264. Push this button to Enable or Disable TWCP. 
  265.  
  266.  
  267. ΓòÉΓòÉΓòÉ 13. Save Button ΓòÉΓòÉΓòÉ
  268.  
  269. Push this button to save your preferences in TWCP.INI. 
  270.  
  271.  
  272. ΓòÉΓòÉΓòÉ 14. About Button ΓòÉΓòÉΓòÉ
  273.  
  274. Push this button to have information on TWCP. 
  275.  
  276.  
  277. ΓòÉΓòÉΓòÉ 15. Auto Minimize Button ΓòÉΓòÉΓòÉ
  278.  
  279. Check this button if you want TWCP to be automatically minimized the next time 
  280. you start the program. 
  281.  
  282. Note:  You should save your preferences pushing the Save button to enable this 
  283. option. 
  284.  
  285.  
  286. ΓòÉΓòÉΓòÉ 16. Auto Enable Button ΓòÉΓòÉΓòÉ
  287.  
  288. Check this button if you want TWCP to be automatically enabled the next time 
  289. you start the program. 
  290.  
  291. Note:  You should save your preferences pushing the Save button to enable this 
  292. option. 
  293.  
  294.  
  295. ΓòÉΓòÉΓòÉ 17. Eliminate Last Carriage Return ΓòÉΓòÉΓòÉ
  296.  
  297. Check this button if you want that TWCP eliminate the last Carriage Return in 
  298. paste operations. 
  299.  
  300. Note:  If you have selected Shift as control button for paste operations, the 
  301. Carriage Return is automatically removed. 
  302.  
  303.  
  304. ΓòÉΓòÉΓòÉ 18. Enable Entry Fields Copy and Paste ΓòÉΓòÉΓòÉ
  305.  
  306. Check this button if you want that TWCP works also with Entry Fields. 
  307.  
  308. Note:  This option works with Entry Field ("#6") and Multi Line Entry Filed 
  309. ("#10") classes. 
  310.  
  311. Warning: If you enable this option, applications' Entry Field will not see the 
  312. mouse click TWCP uses: if a popup menu is associated with that mouse click, it 
  313. will never be activated.