═══ 1. Copyright ═══ TWCP V 1.32 - Text Window Cut and Paste Copyright 1994 by Masar Software Ltd. All rights reserved. This is free software. If you find this program useful, let me know, send a postcard with a photo of your city to: Maurizio Sartori Masar Via MonteGrappa 7 20044 Bernareggio (Milano) ITALY Commercial distribution and/or use is prohibited without written consent by the author. Because the program is licensed free of charge, there is no warranty for the program, to the extent permitted by applicable law. Except when otherwise stated in writing the copyright holders and/or other parties provide the program "as is" without warranty of any kind, either expressed or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. The entire risk as to the quality and performance of the program is with you. Should the program prove defective, you assume the cost of all necessary servicing, repair or correction. In no event unless required by applicable law or agreed to in writing will any copyright holder, or any other party who may modify and/or redistribute the program as permitted above, be liable to you for damages, including any general, special, incidental or consequential damages arising out of the use or inability to use the program (including but not limited to loss of data or data being rendered inaccurate or losses sustained by you or third parties or a failure of the program to operate with any other programs), even if such holder or other party has been advised of the possibility of such damages. ═══ 2. About TWCP ═══ TWCP V 1.32 - Text Window Cut and Paste The TWCP application is a simple Presentation Manager application which let you Mark, Copy and Paste text and graphics from a DOS or OS/2 Window using the mouse, like in X Windows, without passing through the system menu. ═══ 3. History ═══ Version 1.00 o Initial release. Version 1.10 o Added option to eliminate last Carriage Return. Version 1.20 o Rewritten Hook procedure. o Corrected problem with buttons 2 and 3 in mark operations. o Corrected problem with Disable button. o Corrected minor bugs. o Minor changes to documentation (added notes and warning). o Forced use of control key(s) if Button 1 is used for mark. Version 1.30 o Added option to copy and paste in entry fields. o Added option "/L" to lower a window z-order clicking on its title. o Minor esthetical changes Version 1.31 o Corrected problem with minimized icon drawing. o Corrected problem with errors in command line parameters. Version 1.32 o Corrected problem with "/L" option o Enhanced "/L" option to allow use of any combination of mouse button and Shift, Alt and Ctrl keys. ═══ 4. Known Bugs ═══ With OS/2 V 2.11 the TWCP can only be Minimized to Viewer, this is a problem of the Service Pack :-(, with other versions of OS/2 you can Hide, Minimize to Viewer or to Desktop as usual. ═══ 5. Masar Software Ltd ═══ Masar Software Ltd. For bugs or suggestions, please write to: Maurizio Sartori Masar Via MonteGrappa 7 20044 Bernareggio (Milano) ITALY or email to the INTERNET address: masar@cdc8g5.cdc.polimi.it masar@131.175.6.1 Acknowledgments Thanks to Simona who helped me in writing the documentation. ═══ 6. Install ═══ In this package, you should receive these files: ■ TWCP.EXE - Program file ■ TWCPHOOK.DLL - Program hook library ■ TWCP.HLP - Program help file ■ READ.ME - Program description in ASCII format. To install TWCP copy TWCP.EXE in a directory in your PATH, TWCPHOOK.DLL in a directory in your LIBPATH and TWCP.HLP in a directory in your HELP path. That is all, now you can use TWCP. ═══ 7. Command Line Syntax and Options ═══ TWCP has the following syntax: TWCP [/? | /H] [/L[1,2,3,A,S,C]] Where /? /H Print this help. /L Enable Low It option ═══ 7.1. Low It Option ═══ This option is enabled with the /L[opt] switch in the command line. When this option is enabled you can low a window, putting it below all windows, clicking with Button 2 on its Title Bar. You can use the following modifiers to the option: 1 Use mouse button 1. 2 Use mouse button 2 (default). 3 Use mouse button 3. C Use CTRL key with mouse. A Use ALT key with mouse. S Use SHIFT key with mouse. Note: /L1 isn't a valid option! sample: TWCP /L3AC will enable the option using button 3 with ALT and CTRL keys. Warning: When this option is enabled, applications' title bar will not see the button click: if a pop up menu is associated with a click of the button on the title bar, it will never be activated. Note: This option is not saved with the program profile, it must be specified every time TWCP is executed to have effect. ═══ 8. Using ═══ This section explain how to use TWCP. ═══ 8.1. Enabling ═══ To enable TWCP you should: 1. Select the mouse button with which you want to Mark and Copy, checking the corresponding radio button. 2. Chose which control key(s) (Shift, Alt, Ctrl) you would like to use together with the mouse to Mark and Copy, checking the corresponding check button. 3. Select the mouse button with which you want to Paste checking the corresponding radio button. 4. Chose which control key(s) (Shift, Alt, Ctrl) you would like to use together with the mouse to Paste, checking the corresponding check button. 5. Enable TWCP clicking on the ENABLE button. Now you can start to use TWCP. ═══ 8.2. Disabling ═══ To Disable TWCP you should click on the DISABLE button. ═══ 8.3. Marking and Copying ═══ To Mark and Copy a portion of text in a DOS or OS/2 Text window you should do the following: 1. Press the Mark and Copy control key(s). 2. Click the Mark and Copy mouse button where you want to start marking. 3. Drag the mouse, holding down button and key, till the end of the portion of text you want to mark. Now the zone should be highlighted. 4. Release the Mark and Copy mouse button. 5. Release the Mark and Copy key. The text or graphics you marked is automatically copied to the Clipboard. Note: If you release the control key(s) before releasing the mouse button, you remain in mark mode. To complete the operation, restart from point 1. ═══ 8.4. Pasting ═══ To Paste from the Clipboard you should do the following: 1. Press the Paste control key(s). 2. Click the Paste mouse button in the window in which you want to paste. 3. Release the Paste mouse button. 4. Release the Paste key. The text or graphics is automatically pasted to the window. Warning: You should hold down the control key(s) till the paste operation is completed, otherwise the text program could loose the release of the control key(s). ═══ 9. How it works ═══ TWCP works installing a system hook that intercepts every mouse message posted. If the message is directed to a DOS or OS/2 Text Window, that has a window class of type Shield, or to a Entry Field, #6 and #10 classes, and it is a Mark, Copy or Paste key combination, the messages for Mark, Copy or Paste are send to the window. Warning: Because the program relies on the class name, and there can be other windows with class name Shield that aren't DOS or OS/2 Text Windows, the program can fail with those windows. The fields Class and Parent show the class name of every window in which the mouse is clicked. If you find a program that makes fail TWCP please let me know. ═══ 10. Mark and Copy Buttons ═══ Use these buttons to select which mouse button and control key(s) you want to use for Mark and Copy operations. ═══ 11. Paste Buttons ═══ Use these buttons to select which mouse button and control key(s) you want to use for Paste operations. ═══ 12. Enable / Disable Button ═══ Push this button to Enable or Disable TWCP. ═══ 13. Save Button ═══ Push this button to save your preferences in TWCP.INI. ═══ 14. About Button ═══ Push this button to have information on TWCP. ═══ 15. Auto Minimize Button ═══ Check this button if you want TWCP to be automatically minimized the next time you start the program. Note: You should save your preferences pushing the Save button to enable this option. ═══ 16. Auto Enable Button ═══ Check this button if you want TWCP to be automatically enabled the next time you start the program. Note: You should save your preferences pushing the Save button to enable this option. ═══ 17. Eliminate Last Carriage Return ═══ Check this button if you want that TWCP eliminate the last Carriage Return in paste operations. Note: If you have selected Shift as control button for paste operations, the Carriage Return is automatically removed. ═══ 18. Enable Entry Fields Copy and Paste ═══ Check this button if you want that TWCP works also with Entry Fields. Note: This option works with Entry Field ("#6") and Multi Line Entry Filed ("#10") classes. Warning: If you enable this option, applications' Entry Field will not see the mouse click TWCP uses: if a popup menu is associated with that mouse click, it will never be activated.