DragText

________________________________________________________________________ DragText version 3.9 A Distinctly Different Desktop Enhancement (C) Copyright 1994-2003,2007 RL Walsh All Rights Reserved ________________________________________________________________________ DTReadMe.Txt - quick start info for DragText ________________________________________________________________________ C O N T E N T S ____________________ * Introduction * Install / Remove * New and Revised Features - New - Changed * Bugs and Limitations * License Agreement * File List * Feature Summary - Drag - Drop - Related Features - OverDrag ________________________________________________________________________ Introduction ________________________________________________________________________ DragText v3.9 is the latest release of a distinctly different Desktop enhancement for OS/2 Warp. Present almost everywhere yet invisible until needed, DragText lets you do what others can't: Handle Text as an Object - Text in windows, files, and the clipboard becomes an object that can be copied, moved, saved or deleted using drag & drop. Access WPS Objects from Any Program - Treat a filename or Object ID like a shadow of the object it names; use a window's System Menu button as your link to the object that opened it. Drag these objects or use their menus - you can navigate the Desktop without opening a folder or even leaving your app. Eliminate the Obstacles to Drag & Drop - If you've ever cancelled a drag because the target window was covered or the folder you needed wasn't open yet, you'll like OverDrag. Now when you drag, you can click the mouse or press a key to: open folders, scroll windows, minimize & restore them, and more. Rearrange your desktop as you drag, then let DT clean up when you're done. DragText's three WPS classes, DTProgram, DTClip, and DTFile, offer still more features. For a comprehensive listing of DT's primary features, see "Drag, Drop, and Related Features" at the end of this file. All of its features are documented in its online help. DragText works with many popular programs such as editors, emailers, and other internet apps. DT's Basic features free; its Extended features are yours to try for 6 weeks. Continued use costs only $20(US) through Mensys (os2.mensys.nl) or BMT Micro (www.bmtmicro.com). As always, upgrades are free for registered users (reregistration is greatly appreciated). ________________________________________________________________________ Install / Remove ________________________________________________________________________ Run DTSetup to install DragText v3.9. DTSetup should also be used to reinstall or uninstall DragText. Refer to DTSetup.Txt for a full description. If you are upgrading, do *not* uninstall your current version. Instead, have it running and let DTSetup install v3.9 in a *new* directory. It should be able to copy your existing settings and registration info. To revert to a previous version of DragText, use this version's DTSetup to uninstall v3.9. Reboot, then run the copy of DTSetup in the earlier version's installation directory. ________________________________________________________________________ New and Revised Features ________________________________________________________________________ New --- DragText v3.9's primary new feature is NLS support. It uses the 'Lang' environment variable to determine the correct language, then loads the appropriate language support DLL, if available. Translation is easy and no special tools are needed. Open the new 'DTNLS' subdirectory & translate the English phrases in 'dt39_xx.txt'. Then run 'dt39_xx.cmd' and identify your language. The REXX script will create a support dll and copy it to the main directory for immediate use. A complete description of the process can be found in 'dt39_xx.txt'. Changed ------- Odin support has been removed from this version. Existing support no longer worked with later versions of Odin and could not be easily fixed. Several trivial bugs have been fixed. ________________________________________________________________________ Bugs and Limitations ________________________________________________________________________ OverDrag - On slower or heavily loaded systems, windows may not be repainted completely after being raised or lowered. To force an update, use the Redisplay hotkey (letter 'D' by default). When the drag concludes, the screen will be updated automatically. DTProgram - There are limitations on the Environment feature, depending on how a program object is used. This only affects OS/2 programs, not DOS and WinOS/2. See the Help file for additional details. ________________________________________________________________________ License Agreement ________________________________________________________________________ DragText, its executables and documentation, is the copyrighted property of Richard L. Walsh. It is licensed, not given, to you for your personal use. Selected features may require the payment of a registration fee for continued use. You may copy and freely redistribute DragText to others, and may package it with both noncommercial and commercial software products provided: - the recipient agrees to the terms of this license, - you transfer DragText as a whole and intact, and - there is no additional cost to the recipient other than the costs of providing media and transmission. You may not modify DragText in any way nor may you reverse assemble, reverse compile, or otherwise translate or reverse engineer its executable code or data. You may make additions to the documentation, including translations into other languages, provided these are contained in files separate from the originals and are identified as addenda to the accompanying original documentation. DragText is not warranted to be free of defects nor to be suitable for any particular purpose the licensee may put it to. The licensee agrees to use DragText at his or her own risk, and agrees to accept all liabilities arising from its use, including all claims by third parties, without recourse to the author or copyright holder. THERE ARE NO WARRANTIES, EXPRESS OR IMPLIED, OF ANY SORT. BY YOUR USE OF THE PROGRAM YOU AGREE TO THE TERMS OF THIS LICENSE. ________________________________________________________________________ File List ________________________________________________________________________ Archive file drgtxt39.zip contains: 1. drgtxt39.001 2008-01-01 03:09:00 2. drgtxt39.002 2008-01-01 03:09:00 3. drgtxt39.003 2008-01-01 03:09:00 4. drgtxt39.004 2008-01-01 03:09:00 5. drgtxt39.005 2008-01-01 03:09:00 6. drgtxt39.006 2008-01-01 03:09:00 7. drgtxt39.007 2008-01-01 03:09:00 8. drgtxt39.008 2008-01-01 03:09:00 9. dtsetup.exe 2008-01-01 03:09:00 10. dtsetup.txt 2008-01-01 03:09:00 11. dtreadme.txt 2008-01-01 03:09:00 12. dt39_de.dll 2008-01-01 03:09:00 13. dtsetup_de.txt 2008-01-01 03:09:00 14. dtreadme_de.txt 2008-01-01 03:09:00 15. dt39_fr.dll 2008-01-01 03:09:00 16. dtsetup_fr.txt 2008-01-01 03:09:00 17. dtreadme_fr.txt 2008-01-01 03:09:00 18. dt39_it.dll 2008-01-01 03:09:00 19. dtsetup_it.txt 2008-01-01 03:09:00 20. dtreadme_it.txt 2008-01-01 03:09:00 21. dt39_nl.dll 2008-01-01 03:09:00 22. dtsetup_nl.txt 2008-01-01 03:09:00 23. dtreadme_nl.txt 2008-01-01 03:09:00 24. dt39_sv.dll 2008-01-01 03:09:00 25. dtsetup_sv.txt 2008-01-01 03:09:00 26. dtreadme_sv.txt 2008-01-01 03:09:00 27. dtnls39\dt39_xx.txt 2008-01-01 03:09:00 28. dtnls39\dt39_xx.cmd 2008-01-01 03:09:00 29. dtnls39\dtnls39.h 2008-01-01 03:09:00 30. dtnls39\dtnls39.rc 2008-01-01 03:09:00 31. dtnls39\dtnls39.dll 2008-01-01 03:09:00 ________________________________________________________________________ ________________________________________________________________________ Feature Summary ________________________________________________________________________ The following tables provide a complete listing of every DragText feature that involves the use of MB2 (the drag button, usually the right-hand one). DragText's WPS classes provide additional features that are not included here. * Drag * Drop * Related Features * OverDrag ________________________________________________________________________ Drag ________________________________________________________________________ This table identifies: * What you can drag (Dragged Item) * Where it comes from (Drag Source) * How to drag it (Required Action) ┌────────────────────┬───────────────┬──────────────────────────────┐ │Dragged Item │Drag Source │Required Action │ ├────────────────────┼───────────────┼──────────────────────────────┤ │Selected text * │most windows │highlight text, then drag │ │ │ │or press Alt-MB2 to pickup; │ ├────────────────────┼───────────────┼──────────────────────────────┤ │All text * │MLE, Listbox, │press Ctrl, then drag or │ │ │& VIO windows │press Ctrl-Alt-MB2 to pickup; │ │ │ │ │ │ │Entryfield │drag without highlighting, │ │ │& Static text │or press Alt-MB2 to pickup; │ ├────────────────────┼───────────────┼──────────────────────────────┤ │Clipboard text │DTClip icon │drag from icon, │ │ │ │or press Alt-MB2 to pickup; │ ├────────────────────┼───────────────┼──────────────────────────────┤ │File or Object ID │most windows │highlight name or ID, │ │named in text │ │then Ctrl-Shift drag; │ ├────────────────────┼───────────────┼──────────────────────────────┤ │Object that opened │Sysmenu │Ctrl-Shift drag; │ │this window │ │ │ └────────────────────┴───────────────┴──────────────────────────────┘ * Basic (free) feature, except in VIO windows; all other features require registration. ________________________________________________________________________ Drop ________________________________________________________________________ This table identifies: * Where you can drop (Drop Target) * What you can drop (Dragged Item) * Which key is required (Key to Press) * What will happen (Drop Result) ┌─────────────┬───────────────┬────────────────────────────┬────────────┐ │Drop Target │Dragged Item │Drop Result │Key to Press│ ├─────────────┼───────────────┼────────────────────────────┼────────────┤ │Text Window │Dragged text │insert text * │ │ │ │DTFile │insert contents │ │ │ │Url object │insert contents │ │ │ │File / Object │insert path * │ │ │ │ │insert name only * │Shift │ │ │File │insert directory entry + │Ctrl │ │ │ │insert contents + │Alt │ │ │Folder │insert formatted listing + │Alt │ │ │Unknown item │insert app-specific text * │Alt │ ├─────────────┼───────────────┼────────────────────────────┼────────────┤ │Folder │Dragged text │create file │ │ │ │Url text │create Url object │ │ ├─────────────┼───────────────┼────────────────────────────┼────────────┤ │System Menu │File / Object │locate object │ │ │Button │ │open object │Alt │ │ │ │popup object's WPS menu │Ctrl │ ├─────────────┼───────────────┼────────────────────────────┼────────────┤ │Titlebar │same as │copy to DTClip viewer │ │ │ │Text Window │ │ │ ├─────────────┼───────────────┼────────────────────────────┼────────────┤ │DTClip Icon │same as │copy to clipboard │ │ │ │Text Window │append to clipboard │[Insert] % │ ├─────────────┼───────────────┼────────────────────────────┼────────────┤ │DTFile Icon │same as │append to file │ │ │ │Text Window │ │ │ ├─────────────┼───────────────┼────────────────────────────┼────────────┤ │DTProgram │Dragged text │open using text │ │ │Icon │ │as startup parameter; │ │ │ │Multiple files │open using filenames │ │ │ │ │as startup parameter; │Ctrl-Shift │ └─────────────┴───────────────┴────────────────────────────┴────────────┘ NOTE: to drop an object you have picked up, press Ctrl or Shift (to copy or move), then click MB2. To cancel a pickup, Alt-click MB2 on the Desktop or a DragText-enabled window. * Basic (free) feature; all others require registration. + supported only in these windows/objects: MLE, VIO, Titlebar, DTClip, and DTFile % press and release Insert while over a DTClip icon to toggle between append and replace modes ________________________________________________________________________ Related Features ________________________________________________________________________ This table identifies: * What else DT does (Feature) * Where to use it (Window) * How to use it (Usage) * What it does (Result) ┌────────────┬─────────┬─────────────────────────┬──────────────────────────┐ │Feature │Window │Usage │Result │ ├────────────┼─────────┼─────────────────────────┼──────────────────────────┤ │Window Link │Sysmenu │click MB2 │show menu of object that │ │Menus │button │ │opened this window │ │ │ │Ctrl-click MB2 │menu of program object │ │ │ │ │used to open this window │ ├────────────┼─────────┼─────────────────────────┼──────────────────────────┤ │Text Link │text │Ctrl-Shift-click MB2 │show menu for selected │ │Menus │windows │or Ctrl-Shift F10 │filename or object ID │ ├────────────┼─────────┼─────────────────────────┼──────────────────────────┤ │Text Link │text │Ctrl-Shift Enter │open selected filename │ │Open │windows │ │or object ID │ ├────────────┼─────────┼─────────────────────────┼──────────────────────────┤ │Mouse │VIO │drag while pressing MB1 │mark text │ │Marking + │ │press MB2 while marking │copy to clipboard │ │ │ │press MB1+MB2 │paste from clipboard │ ├────────────┼─────────┼─────────────────────────┼──────────────────────────┤ │Background │most │actions using MB2 │window won't be activated │ │Drag * │windows │ │or brought to the top │ └────────────┴─────────┴─────────────────────────┴──────────────────────────┘ * Basic (free) feature; all others require registration. + Options permit selection of MB1 or MB3 for marking, and whether selected keys must be pressed to activate this feature. ________________________________________________________________________ OverDrag ________________________________________________________________________ This table identifies: * What it's called (Feature) * What to press (Mouse / Keyboard) * What it does (Description) ┌─────────┬───────────┬────────────────────────────────┐ │Feature │Mouse / │Description │ │ │Keyboard │ │ ├─────────┼───────────┼────────────────────────────────┤ │Raise │Up arrow │moves the window under the │ │ │ │pointer to the top │ ├─────────┼───────────┼────────────────────────────────┤ │Lower │Down arrow │moves the window under the │ │ │ │pointer to the bottom │ ├─────────┼───────────┼────────────────────────────────┤ │Rotate │Space bar │cycles through all windows under│ │ │ │the pointer. The top window is │ │ │Button 3 │sent to the bottom and the next │ │ │ │window is surfaced. │ ├─────────┼───────────┼────────────────────────────────┤ │Auto │'A' key │turns auto-raise on and off │ │ │ │during d&d without changing the │ │ │ │default setting │ ├─────────┼───────────┼────────────────────────────────┤ │Scroll │Page up │scrolls the window under the │ │ │Page down │pointer by one page │ ├─────────┼───────────┼────────────────────────────────┤ │Minimize │Win key │minimizes or hides the window │ │ │ │under the pointer │ ├─────────┼───────────┼────────────────────────────────┤ │Restore │Win key │restores a window minimized to │ │ │ │the Desktop │ ├─────────┼───────────┼────────────────────────────────┤ │Redisplay│'D' key │redisplays the window under the │ │ │ │pointer │ ├─────────┼───────────┼────────────────────────────────┤ │Open │Enter │opens the folder icon under the │ │folder + │ │pointer │ │ │Button 1 │ │ ├─────────┼───────────┼────────────────────────────────┤ │Surface │Enter │brings an open object's default │ │object + │ │view to the top (including │ │ │Button 1 │objects in the MinWin viewer) │ ├─────────┼───────────┼────────────────────────────────┤ │Open │Enter │over a window's SysMenu button, │ │parent + │ │opens the window's parent folder│ │ │Button 1 │ │ ├─────────┼───────────┼────────────────────────────────┤ │Expand │Enter │over a collapsed branch in Tree │ │branch + │ │view, expands that branch │ │ │Button 1 │ │ └─────────┴───────────┴────────────────────────────────┘ + Extended feature, requires registration. ________________________________________________________________________ ________________________________________________________________________ Rich Walsh <dragtext@e-vertise.com> Ft Myers, FL 2008-01-01 ________________________________________________________________________ ________________________________________________________________________