home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 15 / CD_ASCQ_15_070894.iso / vrac_os2 / twcp130.zip / TWCP.HLP (.txt) < prev    next >
OS/2 Help File  |  1994-01-08  |  22KB  |  278 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Copyright ΓòÉΓòÉΓòÉ
  3.  
  4. TWCP  V 1.30 - 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.30 - 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.  
  77. ΓòÉΓòÉΓòÉ 4. Masar Software Ltd ΓòÉΓòÉΓòÉ
  78.  
  79. Masar Software Ltd. 
  80.  
  81. For bugs or suggestions, please write to: 
  82.  
  83.           Maurizio Sartori Masar
  84.           Via MonteGrappa  7
  85.           20044 Bernareggio
  86.              (Milano)  ITALY
  87.  
  88.  or email to the INTERNET address: 
  89.  
  90.      masar@cdc835.cdc.polimi.it 
  91.      masar@131.175.6.2 
  92.  
  93.  Acknowledgments 
  94.  
  95.  Thanks to Simona who helped me in writing the documentation. 
  96.  
  97.  
  98. ΓòÉΓòÉΓòÉ 5. Install ΓòÉΓòÉΓòÉ
  99.  
  100. In this package, you should receive these files: 
  101.  
  102. Γûá TWCP.EXE      -  Program file
  103. Γûá TWCPHOOK.DLL  -  Program hook library
  104. Γûá TWCP.HLP      -  Program help file
  105. Γûá READ.ME       -  Program description in ASCII format.
  106.  
  107.  To install TWCP copy TWCP.EXE in a directory in your PATH, TWCPHOOK.DLL in a 
  108.  directory in your LIBPATH and TWCP.HLP in a directory in your HELP path. 
  109.  
  110.  That is all, now you can use TWCP. 
  111.  
  112.  
  113. ΓòÉΓòÉΓòÉ 6. Command Line Syntax and Options ΓòÉΓòÉΓòÉ
  114.  
  115. TWCP has the following syntax: 
  116.  
  117.      TWCP [/? | /H] [/B] 
  118.  
  119.  Where 
  120.  
  121.  /? /H     Print this help. 
  122.  /L        Enable Low It option 
  123.  
  124.  
  125. ΓòÉΓòÉΓòÉ 6.1. Low It Option ΓòÉΓòÉΓòÉ
  126.  
  127. This option is enabled with the /L switch in the command line. 
  128.  
  129. When this option is enabled you can low a window, putting it below all windows, 
  130. clicking with Button 2 on its Title Bar. 
  131.  
  132. Warning: When this option is enabled, applications' title bar will not see the 
  133. button 2 click: if a pop up menu is associated with a click of button 2 on the 
  134. title bar, it will never be activated. 
  135.  
  136.  
  137. ΓòÉΓòÉΓòÉ 7. Using ΓòÉΓòÉΓòÉ
  138.  
  139. This section explain how to use TWCP. 
  140.  
  141.  
  142. ΓòÉΓòÉΓòÉ 7.1. Enabling ΓòÉΓòÉΓòÉ
  143.  
  144. To enable TWCP you should: 
  145.  
  146.   1. Select the mouse button with which you want to Mark and Copy, checking the 
  147.      corresponding radio button. 
  148.   2. Chose which control key(s) (Shift, Alt, Ctrl) you would like to use 
  149.      together with the mouse to Mark and Copy, checking the corresponding check 
  150.      button. 
  151.   3. Select the mouse button with which you want to Paste checking the 
  152.      corresponding radio button. 
  153.   4. Chose which control key(s) (Shift, Alt, Ctrl) you would like to use 
  154.      together with the mouse to Paste, checking the corresponding check button. 
  155.   5. Enable TWCP clicking on the ENABLE button. 
  156.  
  157.  Now you can start to use TWCP. 
  158.  
  159.  
  160. ΓòÉΓòÉΓòÉ 7.2. Disabling ΓòÉΓòÉΓòÉ
  161.  
  162. To Disable TWCP you should click on the DISABLE button. 
  163.  
  164.  
  165. ΓòÉΓòÉΓòÉ 7.3. Marking and Copying ΓòÉΓòÉΓòÉ
  166.  
  167. To Mark and Copy a portion of text in a DOS or OS/2 Text window you should do 
  168. the following: 
  169.  
  170.   1. Press the Mark and Copy control key(s). 
  171.   2. Click the Mark and Copy mouse button where you want to start marking. 
  172.   3. Drag the mouse, holding down button and key, till the end of the portion 
  173.      of text you want to mark. Now the zone should be highlighted. 
  174.   4. Release the Mark and Copy mouse button. 
  175.   5. Release the Mark and Copy key. 
  176.  
  177.  The text or graphics you marked is automatically copied to the Clipboard. 
  178.  
  179.  Note:  If you release the control key(s) before releasing the mouse button, 
  180.  you remain in mark mode. To complete the operation, restart from point 1. 
  181.  
  182.  
  183. ΓòÉΓòÉΓòÉ 7.4. Pasting ΓòÉΓòÉΓòÉ
  184.  
  185. To Paste from the Clipboard you should do the following: 
  186.  
  187.   1. Press the Paste control key(s). 
  188.   2. Click the Paste mouse button in the window in which you want to paste. 
  189.   3. Release the Paste mouse button. 
  190.   4. Release the Paste key. 
  191.  
  192.  The text or graphics is automatically pasted to the window. 
  193.  
  194.  Warning: You should hold down the control key(s) till the paste operation is 
  195.  completed, otherwise the text program could loose the release of the control 
  196.  key(s). 
  197.  
  198.  
  199. ΓòÉΓòÉΓòÉ 8. How it works ΓòÉΓòÉΓòÉ
  200.  
  201. TWCP works installing a system hook that intercepts every mouse message posted. 
  202. If the message is directed to a DOS or OS/2 Text Window, that has a window 
  203. class of type Shield, or to a Entry Field, #6 and #10 classes, and it is a 
  204. Mark, Copy or Paste key combination, the messages for Mark, Copy or Paste are 
  205. send to the window. 
  206.  
  207. Warning: Because the program relies on the class name, and there can be other 
  208. windows with class name Shield that aren't DOS or OS/2 Text Windows, the 
  209. program can fail with those windows. 
  210. The fields Class and Parent show the class name of every window in which the 
  211. mouse is clicked. 
  212. If you find a program that makes fail TWCP please let me know. 
  213.  
  214.  
  215. ΓòÉΓòÉΓòÉ 9. Mark and Copy Buttons ΓòÉΓòÉΓòÉ
  216.  
  217. Use these buttons to select which mouse button and control key(s) you want to 
  218. use for Mark and Copy operations. 
  219.  
  220.  
  221. ΓòÉΓòÉΓòÉ 10. Paste Buttons ΓòÉΓòÉΓòÉ
  222.  
  223. Use these buttons to select which mouse button and control key(s) you want to 
  224. use for Paste operations. 
  225.  
  226.  
  227. ΓòÉΓòÉΓòÉ 11. Enable / Disable Button ΓòÉΓòÉΓòÉ
  228.  
  229. Push this button to Enable or Disable TWCP. 
  230.  
  231.  
  232. ΓòÉΓòÉΓòÉ 12. Save Button ΓòÉΓòÉΓòÉ
  233.  
  234. Push this button to save your preferences in TWCP.INI. 
  235.  
  236.  
  237. ΓòÉΓòÉΓòÉ 13. About Button ΓòÉΓòÉΓòÉ
  238.  
  239. Push this button to have information on TWCP. 
  240.  
  241.  
  242. ΓòÉΓòÉΓòÉ 14. Auto Minimize Button ΓòÉΓòÉΓòÉ
  243.  
  244. Check this button if you want TWCP to be automatically minimized the next time 
  245. you start the program. 
  246.  
  247. Note:  You should save your preferences pushing the Save button to enable this 
  248. option. 
  249.  
  250.  
  251. ΓòÉΓòÉΓòÉ 15. Auto Enable Button ΓòÉΓòÉΓòÉ
  252.  
  253. Check this button if you want TWCP to be automatically enabled the next time 
  254. you start the program. 
  255.  
  256. Note:  You should save your preferences pushing the Save button to enable this 
  257. option. 
  258.  
  259.  
  260. ΓòÉΓòÉΓòÉ 16. Eliminate Last Carriage Return ΓòÉΓòÉΓòÉ
  261.  
  262. Check this button if you want that TWCP eliminate the last Carriage Return in 
  263. paste operations. 
  264.  
  265. Note:  If you have selected Shift as control button for paste operations, the 
  266. Carriage Return is automatically removed. 
  267.  
  268.  
  269. ΓòÉΓòÉΓòÉ 17. Enable Entry Fields Copy and Paste ΓòÉΓòÉΓòÉ
  270.  
  271. Check this button if you want that TWCP works also with Entry Fields. 
  272.  
  273. Note:  This option works with Entry Field ("#6") and Multi Line Entry Filed 
  274. ("#10") classes. 
  275.  
  276. Warning: If you enable this option, applications' Entry Field will not see the 
  277. mouse click TWCP uses: if a popup menu is associated with that mouse click, it 
  278. will never be activated.