__________________________________________________________________________ - DragText version 2.0 - The Drag and Drop Enabler for OS/2* (C) Copyright R L Walsh 1994 - 1996 All rights reserved write to rlwalsh@packet.net -- or -- Rich Walsh 315 S. Barbour St Beverly Hills, Florida 34465 U.S.A. __________________________________________________________________________ __________________________________________________________________________ __________________________________________________________________________ DTHelp.Txt ========== This file is the plain-text version of DragText's online Help. It is formatted for printing at 60 lines by 75 characters and should be viewed or printed in a non-proportional font. __________________________________________________________________________ __________________________________________________________________________ Contents __________________________________________________________________________ __________________________________________________________________________ Getting Started --------------- Overview Installation / Removal Running DragText Frequently Asked Questions New and Revised Features in Version 2.0 Using DragText -------------- Features Text, Urls, Files, and Folders Icons and Pointers Modifier Keys and Defaults Supported PM Windows VIO Windows Using Drag and Drop in VIO Windows System Menu Options in VIO Windows Mouse Marking in VIO Windows Disabling DragText in VIO Windows __________________________________________________________________________ __________________________________________________________________________ Contents (continued) __________________________________________________________________________ __________________________________________________________________________ Options Notebook ---------------- Notebook Layout Basic Features Drag Defaults Background Drag Reset notebook to default size Icons and Pointers Other Options Extended Features Enable Extended Features Install/Remove Workplace Classes File Creation Options File Handling Options Directory Listing Options Url Options VIO Options Disable Conflicts with Other Programs Disabling DragText for a Program Add a Program to the Restricted List Change a Program's Restrictions Remove a Program from the List Disabling DragText System-wide Info DLL Info Registration Information Workplace Shell Classes ----------------------- DragText's WPS Classes DTFile Changing the DTFile Icon Using DTFile Append DTFile Append Options DTClip Using DTClip's Icon Using DTClip's Window DTClip as a Clipboard Viewer Moving and Copying DTClip Installing and Removing DTClip DTClip Options About DragText -------------- Registration Direct BMT Micro License Agreement __________________________________________________________________________ Getting Started --------------- __________________________________________________________________________ Overview __________________________________________________________________________ Basic Features -------------- DragText's Basic features add drag-and-drop text features to many commonly used windows: entryfields, listboxes, etc. With DragText, you can copy or move text between these windows using drag-and-drop, delete text by dragging it to the Shredder, and enter a filename by dropping the file's icon into a window. The Basic features are offered without charge and require no registration. Extended Features ----------------- DragText's Extended features provide seamless integration of text with files, directories, Url objects, VIO (command-line) windows, and the Clipboard. Drag text to a Workplace folder to create a file whose title is derived from the text. If the dragged text is a URL, DragText will create a Url object. Drop DragText files and Url objects on any supported window to recover the text. You can drop a file from any source on a multiline entryfield, VIO window, or the Clipboard to insert its contents. The Extended features include two optional WPS classes to provide additional services. DTClip offers a drag and drop interface for the clipboard. You can use the object's icon directly, or open it to display a window that can be used as a clipboard viewer and editor. DTFile permits you to append text to an existing DragText file by dropping it on the file's icon. The Extended features also include support for VIO windows via their existing clipboard interface. Full support for mouse-initiated marking, copying, and pasting is provided. The Extended features are offered as shareware and require registration to prevent them from becoming disabled after your 6-week free trial ends. See the section on Registration details. Compatibility ------------- DragText's features work with many commonly used applications, such as the System Editor (e.exe) and most programs in the Internet Access Kit. It is designed to add these features only to windows which lack them. It should never replace or interfere with the drag-and-drop support provided by your applications. Because its features are added-on, not built-in, it may not work for every possible window and conflicts may arise between DragText and some programs. If a conflict occurs, DragText can be partially or totally disabled for that program using the Disable page in the Options Notebook. __________________________________________________________________________ Installation / Removal __________________________________________________________________________ Installation ------------ The installation program (DTSetup.exe) will:  move DragText's files to the directory of your choice  create a program object for DragText.exe and put it (or a shadow) in your Startup Folder and/or on the Desktop  offer you the option of installing two Workplace Shell classes that provide some of DragText's Extended features  insert several entries in os2.ini to disable DragText for programs known to be incompatible, and  display some information specific to your system. Removal ------- To remove DragText from your system, you can either:  run DTSetup and choose "Uninstall" to partially or completely remove it, or  simply remove the program object from your Startup Folder to keep it from running. DragText's WPS classes can also be installed or removed using the Extended page of the Options notebook. If you uninstall part or all or DragText, you will have to restart your system to remove it from memory if it was previously loaded. __________________________________________________________________________ Running DragText __________________________________________________________________________ The first time DragText.exe is run during a session, it loads itself into memory, displays a copyright message for 3 seconds, and then terminates. DrgTxt20.dll, which implements the drag-and-drop features, remains resident for the rest of the session. You will not see DragText in any list of windows or tasks. All supported windows created AFTER DragText.exe is run will provide drag-and-drop; those created before will not (this is the primary reason for putting DragText in your Startup Folder). Running DragText again will bring up the Options Notebook which has pages that let you:  set options for the Basic features such as the default drag action  configure the settings for the Extended features such as Files and Urls,  Disable DragText for particular programs  provide Info about supported windows and the icons and pointers DragText uses  get DLL info such as usage and errors, and  review Product Information and enter your registration number __________________________________________________________________________ Frequently Asked Questions __________________________________________________________________________ 1. Q: Why can't I move the DTClip icon? A: Dragging from this icon drags the clipboard's contents, not the object. To move/copy/shadow it, have Shift and/or Ctrl pressed when you begin to drag it. See Moving and Copying DTClip for additional ways to manipulate the icon. 2. Q: Why doesn't DragText show up on my window list or task list? A: DragText is NOT a task, process or window, so it won't appear in these lists. Once you load it into memory (by running DragText.Exe), it stays there until you reboot. (If you use Pstat or Watchcat, you will see DrgTxt20.Dll is in the list of dll's that have been loaded.) 3. Q: I completely disabled DragText for program X, but I can still drop text into program X's window. Why doesn't Disable work? A: You can only disable DragText for windows where DragText controls drag and drop. You can tell when it is in control because the mouse pointer will include the letters "DT". If you've enabled DragText's file-creation feature, you cannot prevent other programs from reading files it creates. In this case, program X is in control and will let you transfer text using a DragText file. 4. Q: I set up my mouse so the left button is the "drag button", like in Windows. How come I can't drag any text? A: All the windows that DragText supports use the left button to move the cursor and select text. These functions completely override any drag function assigned to this mouse button. IBM would have to rewrite the software for these windows to change this. You can still use DragText to insert a file's name or contents into a window. 5. Q: I tried disabling DragText for a program that runs in a VIO window, but I can still drag and drop from that window. A: DragText supports the window, not the program whose output appears in it. When you run that program, choose the DragText item in the window's System menu, then turn off drag, drop, and/or mouse marking. See VIO Options for details. 6. Q: Why doesn't DragText work for one particular window in my program when it works for all the others. A: There are at least two possible reasons:  your program already supports drag and drop for this window; since drag and drop isn't a visible feature, you may be unaware of it;  the program may have installed some sort of special handling for this window that completely bypasses DragText. 7. Q: How do I change the default icon for DragText files? A: If you chose to install the "DTFile" WPS class, create an icon file named "MYFILE.ICO" and put it in your DragText directory. 8. Q: The Settings notebook for a DragText file shows three entries under "Current types". Are they necessary? A: Yes. The first (",Plain Text," with commas before and after) works around an incompatibility between the Workplace Shell and the system's drag and drop functions. The second ("Plain Text") associates these files with your editor; it also avoids problems when using System Editor. The third ("DragText") is used by the DTFile class and by DragText itself to identify these as DragText files. __________________________________________________________________________ New and Revised Features in Version 2.0 __________________________________________________________________________ This version of DragText has been designated v2.0 because of a major revision in its architecture that enables it to support windows that are derived from those supported by previous versions (v1.x). New Features ------------  VIO (text-mode) window support via the clipboard. Mouse- initiated text marking is included. Support for drag and drop and mouse-marking can be enabled/disabled from the window's System menu. (See VIO Windows)  A WPS-based Clipboard object that operates like a DragText-enabled window. The object can be opened to display a floating clipboard viewer and editor. (See DTClip)  Drop text or a file on an existing DragText file to append it to the existing text. (See DTFile)  Open program objects by dropping text on them.  Print dragged text by dropping it on a printer object.  Install and remove DragText's WPS classes from within its Options Notebook. (See Install/Remove WPS Classes) Revised Features ----------------  Temporary files are handled differently than in prior versions and their creation is now the default. They must be enabled to open objects, print text, and drop text on windows that won't accept dragged text but will accept a file. The "create a pipe" option has been removed. Creating a DragText file when this option is enabled will cause the WPS to display a Copy dialog if you have its "Confirm on move, copy, shadow" option set. The file name shown will be that of the temp file. However, the copied file will have the standard DragText-style file name.  The DTFile WPS class now supports templates and the "Create Another" option on each object's context menu. A default template that is deleteable is created when you register the class.  Unreadable entryfields (i.e. those which display asterisks rather than text) can no longer be dragged from. DragText now honors this attempt at providing security.  Url object titles no longer include any periods. They are removed to prevent the system from misidentifying part of a Url as a file extension.  The Options Notebook has been revised to accommodate the new features. There is now a separate side-tab for files in the "Extended" section of the notebook. Please note that there are two pages associated with this tab. Use the page buttons to access the second page.  Entering registration info causes all Extended features to be turned on when you reopen the Options notebook. Formerly, these had to be reenabled manually. You must still close the notebook, then run dragtext.exe again to put your registration in effect. __________________________________________________________________________ Using DragText -------------- __________________________________________________________________________ Features __________________________________________________________________________ When all features are enabled, DragText lets you use drag and drop to  copy, move, or delete text  create files and Url objects  insert the contents of files and Url objects in supported windows  create a formatted listing of a folder's directory  append text to existing DragText files  copy text to and from the clipboard To help you identify the results from a drag and drop operation, DragText uses up to six icons and three pointers. These results can be changed by using modifier keys or by setting DragText's default actions to suit your needs. All of this is explained in detail in the following sections.  Text, Urls, Files, and Folders  Icons and Pointers  Modifier Keys and Defaults  Supported PM Windows  VIO Windows __________________________________________________________________________ Text, Urls, Files, and Folders __________________________________________________________________________ Dragging Text ------------- To drag text out of any supported window , highlight it, then begin dragging from anywhere within the window. You do not have to point at the selection nor does it have to be visible (e.g. in an MLE, you can scroll it out of view). (Note: for single-line Entryfields begin dragging without any highlighting to drag the entire contents of the field.) As you move the pointer over different windows, the icon and pointer will change to indicate what will happen if you drop the text at that point. For DragText-enabled windows, the text will be inserted into editable fields and matching text will be selected in listboxes and readonly spinbuttons (see restrictions below). You can delete text by dragging it to the Shredder. When the Extended features are enabled, dropping text into a Workplace folder will create a file, or a Url object if the text was a Url. You may also be able to insert text into a window that is not DragText-enabled if the program permits you to drop a file on it. In this case, DragText's "create a file" icon will be visible, not its "insert text" icon. You must have the Temporary Files option turned on for this to be successful. Dragging Files and Folders -------------------------- With the Basic features, you can drop a file or folder into any supported window to insert its fully-qualified name. Using the Extended features, you can drop a DragText-created file into any window to insert its text. You can also insert the contents of any file into a multiline entryfield by pressing Alt before you drop it. Press Alt before you drop a folder to insert a formatted listing of its directory. The formatting is controlled by the settings on the Directory Options page (Files->Dirs) of the Options notebook. Restrictions: While you can copy text from any supported window , you can only move or delete text from editable windows (i.e. those which aren't read-only or listboxes). Similarly, you can only move text into editable windows. To comply with CUA standards, you cannot copy text onto itself; you can override this by pressing Ctrl before you drop. Also, you can only drop one file icon into a window at a time. __________________________________________________________________________ Icons and Pointers __________________________________________________________________________ DragText uses mouse pointers to indicate whether DragText itself controls what will happen. If it is in control, DragText will change icons as you drag to show what will happen if you make a drop. When your drop creates a new file, DragText assigns the file a default icon. Pointers -------- Whenever you drag text or a file over a window that DragText controls, the mouse pointer will always include the letters 'DT', and DragText will decide whether a drop is permitted. If the pointer does not say 'DT', the program that owns the window is in control and it determines whether a drop is acceptable. In this case, there is nothing DragText can do to prevent the program from accepting a drop. DragText uses three pointers: Insert - text will be inserted into editable fields; text will be matched and selected in listboxes and spinbuttons Replace - used only for single-line entryfields to indicate that dropped text will completely replace the current contents. Press and release the Insert key in a normal fashion to toggle between insert and replace. Illegal - DragText will not permit a drop Drag Icons ---------- With all Extended Features enabled, DragText switches among six different icons. If only the Basic Features are enabled, it uses two. This feature is disabled if you have one of the original versions of OS/2 Warp v3.0 because of a bug in them (see Change Icons for more information). DragText uses these icons: Text - text will be inserted into editable fields; matching text will be selected in listboxes and readonly spinbuttons [Basic and Extended features]. This icon is also used when you drag a DragText-created file over any DragText-enabled window [Extended features]. Note: if Change Icons is disabled, this is the only icon that will be used. File - this icon never appears over a DragText-enabled window. Over the Workplace Shell, a drop will create a file; elsewhere, text will be transfered to the target program via a file [Extended features]. Url object - if the text you are dragging is a URL, this icon appears after you leave a DragText window. Over the Workplace Shell, a drop will create a WPS Url object; elsewhere, text will be transfered to the target program via file [Extended features]. File Name - when you drag a file or folder over a DragText window, this icon replaces the original to show that the file or folder's fully qualified name will be inserted [Basic and Extended features]. File Contents - appears only when dragging a file over a multiline entryfield (you may have to press the Alt key). The file's contents will be inserted [Extended features]. Folder Contents - appears only when dragging a folder over a multiline entryfield (you must press the Alt key). A listing of the folder's contents will be inserted [Extended features]. File Icon --------- The default icon assigned to files DragText creates is the same as the file icon shown above. To avoid wasting disk space, DragText files share a single icon which is supplied by the DTFile WPS class. You can change the default to an icon of your choice by creating an icon file named "MYFILE.ICO" and putting it in your DragText directory. __________________________________________________________________________ Modifier Keys and Defaults __________________________________________________________________________ Modifier Keys ------------- DragText uses standard modifier keys and adds two others to override the default action. Except for the Insert key, press and hold them before you drop, NOT when you begin a drag. For Insert, press and release immediately while over an entryfield; do NOT hold it down. Ctrl  copy text and DragText files  copy text onto itself  for files, insert the file's formatted directory entry rather than its fully-qualified name (this usage may change in future versions) Shift  move text  copy a DragText file then delete it  you can never move folders or files from other sources Alt  over MLEs, VIO windows, DTFile and DTClip objects, insert a file's contents  over MLEs, VIO windows, DTFile and DTClip objects, insert a folder's directory listing Insert  over a single-line entryfield or a DTClip object's viewer window, toggle between inserting the dropped text into the current contents, and replacing the current contents with the dropped text. Defaults -------- In all cases, the default operation is Copy. You can change these defaults: On the Options page  copy/move text within a window  copy/move text between windows  insert/replace text in entryfields On the File Handling page:  copy/move text from a window into a DragText file  copy/move a DragText file into a window  insert a file's name/contents into MLEs, etc. __________________________________________________________________________ Supported PM Windows __________________________________________________________________________ DragText works with six commonly-used types of windows found in most every application. They may be used as the app's main window, or only in its dialogs and notebooks. An example of each window appears on the Info page in the Options Notebook DragText also supports VIO (command-line) windows as an Extended feature. Refer to VIO Windows for details. Entryfield ---------- usually contains a single piece of information, such as a filename.  to drag the entire contents, don't highlight any text, just drag  to replace the entire contents, quickly press and release the Insert key while over the field. The mouse pointer will change to show that you're in Replace mode. Note: You can not drag text from "unreadable" entryfields (those which display asterisks rather than text). You can still drop text on them. Multi-line Entryfield --------------------- often used as the main text window in simpler apps such as the System Editor.  insert the contents of any file by pressing the Alt key before you drop the file's icon.  enter a formatted listing for a directory by pressing the Alt key before you drop the folder's icon (see Directory Listing Options for details). Listbox ------- dropping text will cause DragText to search for a matching item. If found, it will be selected (highlighted); if not, you'll hear a beep. DragText will never insert text into a listbox. Combobox -------- combines an entryfield with a listbox. DragText handles each part as if it were a stand-alone window, with one exception. If the entryfield is read-only, dropping text on it will cause a search of the listbox for a matching entry Spin Button ----------- combines an entryfield with a button. If the entryfield part can be edited, it will be handled like a stand-alone entryfield. If it is read-only, DragText will search for a matching item. If found, it will be displayed; otherwise, you'll hear a beep. Static Text ----------- used to display text that can't be edited, such as labels and error messages. You can drag text from static text windows but you can never drop anything on them. Note: You should be aware that some programs create their own window-types that closely resemble the standard ones. DragText may not support these look-alikes. __________________________________________________________________________ VIO Windows __________________________________________________________________________ Sometimes referred to as "text-mode" or "command-line" windows, VIO windows let OS/2 and DOS programs that were designed to use the full screen run on the Desktop in a window. Support for these windows is one of DragText's Extended features Because the internal functioning of VIO windows is entirely undocumented, DragText must rely on their existing clipboard interface to move text in and out of them. This is the only type of window where DragText uses the clipboard. For all other supported windows windows, its operations are completely independent of the clipboard. Refer to these sections for details on using DragText in VIO windows:  Using Drag and Drop  System Menu Options  Mouse Marking  Disabling DragText __________________________________________________________________________ Using Drag and Drop in VIO Windows __________________________________________________________________________ Drag ---- Select the text to be dragged using either DragText's marking feature or another similar facility, then begin dragging. The text will be copied to the clipboard where DragText can access it and handle it like text from any other window. Drop ---- Text dropped on a VIO window is first copied to the clipboard, then pasted into the window at the current cursor location. For some OS/2 text-mode apps that offer mouse support, the cursor may move to the drop location. Dropping a file inserts either its name or contents; you can set the default on the Extended->File Handling Options page in DragText's Options notebook (page 2 of the Files section). __________________________________________________________________________ System Menu Options in VIO Windows __________________________________________________________________________ DragText adds a new entry to the System Menu for VIO windows. Choosing it displays a submenu that lets you turn these features on or off for that window only:  Mouse Marking  Drag  Drop The initial settings for each window are controlled by the Extended->VIO Options page in DragText's Options notebook. __________________________________________________________________________ Mouse Marking in VIO Windows __________________________________________________________________________ DragText provides a mouse-initiated marking feature that operates similarly to that included in Warp v4.0 but is somewhat more flexible. You can choose whether to use mouse button 1 or 3 for marking, and whether a specific key must be pressed for it to become active. These options are set using the Extended->VIO Options page in DragText's Options notebook. The only mouse action needed to use DragText is Mark. However, for your convenience, all of the standard mouse actions are supported: Mark Press MB1 or MB3, then start moving the mouse. When you release the button, the text will remain marked, ready for it to be dragged. Copy While marking (i.e. while MB1 or 3 is still down), press MB2. The marked text will be copied to the clipboard and the highlighting will be removed. Paste Press MB1 (or MB3) and MB2 at the same time. The current contents of the clipboard will be pasted at the cursor location (not at the mouse pointer). __________________________________________________________________________ Disabling DragText in VIO Windows __________________________________________________________________________ DragText provides support for the window, NOT the program running in the window. You cannot disable DragText for specific apps that run in a VIO window. If you encounter problems, you can disable it in either of two ways:  from the Extended page of DragText's Options notebook so that it cannot be turned on for any window, or  from the Extended->VIO Options page so that it can be turned on for selected windows from their System Menu. __________________________________________________________________________ Options Notebook __________________________________________________________________________ Notebook Layout __________________________________________________________________________ Whenever you need to change DragText's defaults or get help on using it, run DragText to open its Options Notebook. There are four major sections, each with a tab at the top of the notebook: Basic set the default actions for DragText's Basic features Extended set the default actions for DragText's Extended features Disable restrict DragText's operation for any programs you specify Info get quick help, review error messages, enter your registration All settings take effect as soon as you press the "Apply" button, change pages in the notebook, or close it. __________________________________________________________________________ Basic Features __________________________________________________________________________ The two Basic pages let you set the default actions for DragText's Basic features. All settings take effect as soon as you press the "Apply" button, change pages in the notebook, or close it. __________________________________________________________________________ Drag Defaults __________________________________________________________________________ Between Windows --------------- when dragging text from one window to another, this determines whether the default action will be to copy or move the text Within a Window --------------- when dragging text from one part of a window to another, this determines whether the the text will be copied or moved These defaults can be overridden by pressing the Ctrl key (to copy) or the Shift key (to move). Note: In many situations, a move operation is not possible. If the default is set to move, the text will be copied instead. If you explicitly request a move by pressing the Shift key, the operation will be refused. Drops into entryfields ---------------------- When you drop text from another window into an entryfield (or the entryfield portion of a combobox or spin button), you can choose to have it:  inserted into the existing text (the initial setting)  completely replace the existing text (the recommended setting) When set to insert, DragText's 'I-beam' mouse pointer will be used. When set to replace, the mouse pointer will change to an I-beam followed by three X's. (See Icons and Pointers ) In use, press and immediately release the Insert key while over an entryfield to toggle between insert and replace. You must be over a DragText-enabled window when you press Insert to avoid changing the system's global insert state. __________________________________________________________________________ Background Drag __________________________________________________________________________ This option keeps a DragText-enabled window from coming to the top when you press mouse button 2 ("MB2", usually the right-hand button). Enabling this feature will prevent the source of a drag from covering the intended target. Your choices are:  never: this feature is disabled  always: this feature is enabled  Ctrl+MB2 only: this feature is active only when you press and hold the Ctrl key as you press mouse button 2 You can disable this feature on a program-by-program basis using the Disable page. Important:  This option affects all MB2 actions in DragText-enabled windows. If the window has a popup menu, clicking MB2 will display the menu on top of all other windows but the window itself will remain partially covered.  You can perform a drag even if the highlighted text is completely covered. Begin dragging from whatever portion of the window is visible.  Some utility programs that add new functions to the mouse buttons may interfere with this DragText feature. __________________________________________________________________________ Reset notebook to default size __________________________________________________________________________ Each time you close the Options Notebook, DragText saves its current size, position, and display attributes (e.g. the font used for notebook tab text). Use this checkbox to restore all of these to their default values the next time you run DragText.exe. This is particularly useful if you change display resolutions. __________________________________________________________________________ Icons and Pointers __________________________________________________________________________ Pointer Size ------------ You can choose whether DragText uses Normal sized I-beam and Illegal mouse pointers or Large ones that may be more appropriate for high-resolution displays. Change Icons ------------ This controls whether DragText automatically determines if it is safe to change the icon as you drag text or files over a DragText-enabled window. See below for a detailed explanation. Your choices are:  auto-detect: DragText will perform the check described below. This is the default.  yes: change icons, regardless of the build level.  no: do not change icons, regardless of the build level. Details When you drag text or files over a DragText window, DragText can change the dragged icon to identify what will happen if you drop it. However, a bug in all of the original releases of OS/2 Warp v3.0 will cause the source application to crash if this feature is enabled. The problem can be corrected by installing Warp Fixpack 8 or later (Fixpack 22 was the latest available, as of October, 1996). It is also fixed in v4.0. At startup, DragText examines the "buildlevel" of PMMERGE.DLL to see if this fix is installed and then enables or disables this feature accordingly. The results of its findings are displayed here (either auto-detect = yes or auto-detect = no). If DragText misidentifies the buildlevel, you can override it with this setting. To identify the buildlevel yourself, enter "ver /r" at an OS/2 command prompt. This feature should be enabled if the buildlevel is 8.232 or higher. Cache Icons ----------- DragText doesn't load an icon until it is needed. It can then save it for later use or it can delete it to free up memory. Unless you run many programs simultaneously and are short of memory, you should probably leave caching enabled.  yes: leave icons in memory; this is the default.  no: delete the icon after use; this will free all icons, including those previously cached. __________________________________________________________________________ Other Options __________________________________________________________________________ Hilite Dropped Text ------------------- When set to yes, DragText will highlight the text you drop into an editable window. This permits you to repeatedly copy the same text, and makes it easier to move or delete text dropped in error. Error Notification ------------------ This determines whether DragText notifies you when it encounters an error. When set to beep, DragText will make a distinctive two-note beep. This is the initial and recommended setting. When set to None, DragText will not notify you. In any case, the most recent error message can be viewed on the DLL Info page. Startup Delay ------------- If keeping DragText in your Startup Folder causes problems (e.g. the Desktop hangs), you can have DragText pause before installing itself. Giving the WPS and other programs time to finish their initialization should eliminate any conflicts. Set this to None if you're not having problems. Otherwise, see how many seconds pass from the time objects in your Startup Folder are run until your disk drives cease most activity. Then select an equivalent Startup Delay. For most systems, this should be 10 to 30 seconds. __________________________________________________________________________ Extended Features __________________________________________________________________________ The six pages under the Extended tab let you set the default actions for DragText's Extended features. These features require registration for use after your 6-week trial period end. All settings take effect as soon as you press the "Apply" button, change pages in the notebook, or close it.  Enable Extended Features  Workplace Classes  File Creation Options  File Handling Options  Directory Listing Options  Url Options  VIO Options __________________________________________________________________________ Enable Extended Features __________________________________________________________________________ Enable all or parts of DragText's Extended features systemwide. Files ----- Create files by dropping text on a folder or the Desktop. Read files and directories by dropping them on any supported window or object. This feature can be disabled for specific programs using the Disable page. Url objects ----------- DragText will create a Url object or file if the text you drop on a folder or the Desktop is recognized as a Uniform Resource Locator. DragText will remove any embedded spaces and newline characters, and will assign the object or file a name based on the Url. If this feature is disabled, DragText will handle Urls like any other dragged text. VIO windows ----------- Text can be dragged from VIO (text-mode) windows and text or files can be dropped onto them. Unlike any other windows, DragText must use the clipboard to accomplish this. Each drag or drop involving a VIO window will overwrite the current contents of the clipboard. To make marking VIO text easier, DragText offers a mouse-initiated marking feature similar to Warp v4.0 but somewhat more flexible. Clipboard Object ---------------- If the DTClip class is registered, the clipboard object it creates can be used like any other DragText-enabled window. You can either use the object's icon to drag and drop text to and from the clipboard, or you can open it to display a window that can be used as a clipboard viewer and editor. DTFile append ------------- If the DTFile class is registered, text or a file can be dropped on a DragText file to append it to the existing contents. __________________________________________________________________________ Install/Remove Workplace Classes __________________________________________________________________________ DragText uses two Workplace Shell classes, DTFile and DTClip, to provide some of its Extended features. These classes can be installed or removed at any time, regardless of whether any Extended features are enabled. When you turn to the Extended page, DragText checks to see if each class is currently registered. It then sets the button next to each name accordingly, either to Install or Remove Install ------- DragText will attempt to register the corresponding WPS class. For DTClip, it will also attempt to create a Clipboard Object on the Desktop named "DTClip". When complete, it will display a popup message window that says whether it succeeded or failed. If installation succeeds, the button will change to Remove. You may have to restart your system for existing DragText files to acquire the new features provided by DTFile. This should not be necessary for DTClip. Also, be sure the features provided by these classes are enabled in the Enable Extended Features section of the Extended page. If installation fails, the button may still change to Remove. If so, you should press it again so that Install reappears. The most likely reason for failure is that DTFile20.Dll or DTClip20.Dll could not be found in your DragText directory (all of DragText's program files must be in the same directory as DragText.Exe). Remove ------ DragText will display a message explaining what it is about to do, and will ask for confirmation. If you press OK, it will attempt to remove the corresponding WPS class. For DTClip, it will first try to delete the Clipboard Object it created when you installed this class. For DTFile, it will not delete any files. When complete, it will display a popup message window that says whether it succeeded or failed. It is very unlikely that this will fail. For DTFile, you may have to restart your system to remove it from memory. Recreating the Clipboard Object ------------------------------- If you need to recreate your Clipboard Object (perhaps because you accidentally deleted it), simply remove the DTClip class, then install it again. __________________________________________________________________________ File Creation Options __________________________________________________________________________ File and Url Titles ------------------- DragText files are given meaningful names based on the first few words of the text. Url objects' names are based on the Url itself. These options control how the will be formatted. Lines: the maximum number of lines the title will use when displayed in a Workplace folder Chars: the maximum number of characters in each line +/- Chars: DragText can add or subtract this many characters to a line to avoid splitting a word in two Replace punctuation with: this character will replace one or more consecutive spaces, punctuation, and control characters in file titles (but not in Url titles) Temporary Files --------------- These settings control whether DragText will create a temporary file every time you begin dragging text. A temporary file is NOT needed to drop text on a folder or the Desktop to create a file. It is needed to drop text on: programs that will only accept a file; printer objects; and program objects (such as editors) to open them. Because DragText uses a separate thread to create its temporary file, this shouldn't have a significant impact on overall performance. Create temp files:  always: this is the most reliable setting for transferring text via a file, and is the default setting. However, there will be background disk activity whenever you begin dragging text.  Urls only: a temporary file will be created only if the text is recognized as a URL. This lets you drop Urls on your Web browser icon to open the program and load the Url, but avoids disk activity for other types of text.  never: this is the best setting if your apps will accept dragged text directly and you don't need to drop text on Workplace objects other than folders. File Name: the name DragText uses when creating a file for any text other than a Url; it is reused every time you begin a drag. The name must conform to the 8.3 naming convention. The default value is "DT_TEXT". Url Name: the name DragText uses when creating a file for Url text; it is reused every time you drag a Url. The name must conform to the 8.3 naming convention. The default value is "DT_URL". Path: the disk directory where the temporary file is stored. The default value is the directory where DragText.Exe is stored. Note: If "Create temp files" is enabled, and you have the Workplace's "confirm copy" option set, a confirmation dialog will appear whenever you drop text on a folder or the Desktop. The file name shown will be that of the temporary file. However, the copied file will have a name based on the text or Url. __________________________________________________________________________ File Handling Options __________________________________________________________________________ These options control how DragText will handle files dropped on supported windows and objects. DragText Files -------------- Creating a file: the text used to create a file can be either copied or moved (i.e. deleted) from the source window. Override the default by pressing Shift to move or Ctrl to copy when you drop the text. Dropping a DTFile: when you drop a DragText file on a supported window, you can either copy or delete (i.e. move) the file. You can override the default by pressing Shift to move or Ctrl to copy. Other Files ------------ When you drop a file DragText didn't create on one of these windows or objects, DragText will insert either the file's complete name or the file's contents. If it inserts the contents, DragText will replace all nulls with spaces and remove any trailing end-of-file (Ctrl-Z) character. You can toggle these settings by pressing Alt when you drop the file. __________________________________________________________________________ Directory Listing Options __________________________________________________________________________ If you drop a Workplace folder on a multiline entryfield while pressing Alt, DragText will insert a formatted listing of the files in that disk directory. This listing will not include non-file objects (such as program objects or shadows). This feature can be used to create simple batch files, as shown in Example 2 below. Include ------- edit window: like any request for a directory listing, this determines which files will be included. The default is "*" which includes all files. You could change this to "*.exe" to include only programs, or to "a*" to include only files whose names begin with the letter "a". Flags: this lets you include or exclude files based on their standard attributes: Directory, Read-only, Archived, Hidden, and System. Plus ("+") includes files with that attribute while minus ("-") excludes files with the attribute. Equal ("=") requires a file to have the attribute to be included. The default value of all pluses includes all files. Setting the flags to "+D -R +A =H +S" would produce a listing of hidden files that weren't also read-only Listing Format -------------- This sets the formatting for each file in the listing. You can enter meta-characters (see below), fixed text, tabs, and carriage returns. (Note: you must include a carriage return if you want each entry to appear on a separate line.) The default value is "%# %d %t %s %a %f" , followed by a carriage return. If you erase the contents of this field, DragText will fill in the default value; it cannot be left blank. Heading Format -------------- This produces a heading for your listing. You may include fixed text, control characters, and the meta-characters for the path and file. The file meta-character will be replaced by the search string. If this field is left blank, no heading will be produced. Meta-Characters --------------- These represent the various components of a directory listing: %p pathname as it appears on the disk with both upper and lowercase letters %P pathname with all letters converted to uppercase %f filename as it appears on the disk with both upper and lowercase letters %F filename with all letters converted to uppercase %n filename without its extension with both upper and lowercase letters %N filename without its extension with all letters converted to uppercase %e filename extension with both upper and lowercase letters %E filename extension with all letters converted to uppercase %d file date (same as %D) using your country's standard format %D file date (same as %d) using your country's standard format %t file time as HH:MM (plus AM or PM if you use a 12-hour clock) %T file time as HH:MM:SS (plus AM or PM if you use a 12-hour clock) %s file size to a maximum of 7 digits; if the size is 10 million or more, this field will contain 7 asterisks (i.e. "*******") %S file size to a maximum of 10 digits %a file attributes (including the directory flag) in lowercase letters %A file attributes (including the directory flag) in uppercase letters %# the sequence number of this entry, starting at 1 %% used to include a percent sign in your fixed text Note: the pathname will not include a final backslash unless it is immediately followed by the filename Example 1 - verbose listing [Heading] Directory listing for %p [Listing] File %F was created on %d at %T [Output] Directory listing for C:\DragText File DRAGTEXT.EXE was created on 12-25-95 at 01:10:00 File DRAGTEXT.DLL was created on 12-25-95 at 01:10:00 [etc.] Example 2 - creating a batch file [Heading] cd %p [Listing] ren %f %F [Output] cd C:\DragText ren DragText.Exe DRAGTEXT.EXE ren DragText.Dll DRAGTEXT.DLL [etc.] __________________________________________________________________________ Url Options __________________________________________________________________________ If this feature is enabled, DragText will create a Url object or file if the text you drop on a folder or the Desktop is recognized as a Uniform Resource Locator. DragText will create a WPS object if either the WPUrl or WebExplorer_ Url class is registered. Otherwise, it will create a file that is functionally identical to an object, except for the class-specific settings notebook. Either can be dropped on IBM's WebExplorer or other compatible Web browsers to load the Url. Url Identifiers --------------- When the beginning of your text matches one of these prefixes, DragText creates a Url object. The default values are "http:// ftp://". You can add any identifier that your Web browser supports; for example, you could add "gopher://". Separate each identifier with a space. DragText can also recognize incomplete Urls and fill in the missing identifier. Enter the identifier surrounded by angle brackets ('<' and '>'), followed by the letters DragText should try to match. The default values are "www. ftp." . Notice that each ends with a period: this should keep DragText from misidentifying sentences beginning with these letters. Title Options ------------- DragText uses these options, plus its own rules, to format the Url as a title. They do not affect the object's contents. Remove from Hostname: to provide shorter and more meaningful titles, you can have DragText remove unnecessary words from the hostname portion of the Url. Each portion of the name, delimited by a dot or a slash, is compared to this list; if it matches, the word is eliminated. The wildcard characters '*' and '?' can be used. The default values are "www* com net edu org ??" . Using "www*" will remove "www", "www1", "www-os2", etc. Using "??" will remove all two-letter words, such as country identifiers (e.g. "ca" or "de"). Line break after hostname: when checked, only the hostname will appear on the first line of the title. Any path information will begin on the second line. If the hostname is long enough to wrap to line 2, no line break will be added. Hostname only: when checked, the Url title will include only the hostname. No path information will appear in the title. __________________________________________________________________________ VIO Options __________________________________________________________________________ If VIO support is enabled, you can drag text and files into and out of these windows, subject to the settings on this page. For details on DragText's VIO support, refer to VIO Window Overview Options ------- Drag & Drop: Controls whether drag and/or drop is enabled for a VIO window when it is first opened. Each VIO window has a DragText item in its System Menu that lets you change this setting for that window only. Mouse Marking: Controls whether DragText's marking feature is enabled for a VIO window when it is first opened. Each VIO window has a DragText item in its System Menu that lets you change this setting for that window only. Refer to Mouse Marking for details on how this feature works. Files: Controls whether files can be created using text dragged from VIO windows, and whether existing files can be dropped in them to read the file's contents. This is a global setting that affects all VIO windows. Mouse Marking ------------- DragText provides a mouse-initiated marking feature that operates similarly to that included in Warp v4.0 but is somewhat more flexible. DragText's marking feature will usually override other marking utilities that use the same combination of mouse buttons and keys. Refer to Mouse Marking for details on how this feature works. Button: Controls which button will be used for marking text.  mouse button 1 - usually the left mouse button  mouse button 3 - the middle button on a 3-button mouse Keyboard: Controls whether particular keys must be pressed along with the mouse button for DragText's marking feature to become active. This lets you avoid conflicts with both a VIO application's use of the mouse and with other marking utilities. Your options are:  various combinations of Shift, Ctrl, and Alt - the selected key or keys must be pressed for DragText to take action  no keys pressed - DragText will ignore the mouse action if Shift, Ctrl, or Alt are pressed  ignore keyboard - DragText's marking feature will become active regardless of whether any keys are pressed. Remove last carriage return When checked, DragText will delete the carriage return that the system adds following the last line of text. __________________________________________________________________________ Disable __________________________________________________________________________ The Disable page lets you restrict DragText's operation for any Presentation Manager-based programs you specify (e.g. System Editor). You cannot disable it for specific programs that run in a VIO (text-mode) window (e.g. TEdit). If necessary, you can disable it for a particular VIO window from that window's System menu (refer to Enable Extended Features for details). Normally, DragText is enabled for all programs. However, if it conflicts with an application's use of drag-and-drop, you can partially or totally disable DragText for that program. The "Program" section of the dialog contains a list of all applications that currently have restrictions. The checkboxes under "Uncheck to Disable" show the window types on which DragText operates. If a box is checked, DragText is enabled. If DragText's Extended features are enabled, you can disable them for a specific program. Uncheck Drag to disable file and Url object creation; uncheck Drop to disable reading files, directories, and Url objects. You can also disable Background Drag for specific programs. Important: you can only disable file operations for DragText-enabled windows. These are windows where the mouse pointer changes to one of DragText's unique pointers (see Icons and Pointers for details). You cannot prevent a program that accepts dropped files from accepting text rendered as a file or Url object. For example, if you drag a Url from a DragText window, you cannot prevent IBM's WebExplorer from accepting it because DragText does not control WebExplorer's drag and drop features. Notes:  Restrictions are checked when a program is launched, not during its execution. To add a restriction, close the application program, add the restriction, then restart the program.  Only programs with restrictions are saved. Programs whose settings match the default (no restrictions) will be dropped from the list and will not appear next time you run DragText. This is done to enhance DragText's performance. __________________________________________________________________________ Conflicts with Other Programs __________________________________________________________________________ DragText knows very little about the programs it works with and they know absolutely nothing about DragText. Because of this, conflicts are possible - particularly with applications that have their own drag and drop functions. DragText can usually tell when a program is handling drag and drop and avoids getting involved. When this fails, you may get an error message or unexpected results. To eliminate this problem, use the Disable page to disable DragText partially or totally for that program. It usually isn't necessary to disable DragText totally; in most cases, disabling the particular type of window that is causing trouble will suffice. You may find that disabling only drags or only drops for that window will solve the problem. Restrictions are checked when a program is launched, not during its execution. To add a restriction, close the application program, add the restriction, then restart the program. Note: Most error messages arise from other problems in the system and are not directly the result of a conflict between DragText and your application program. Add a Program to the Restricted List ------------------------------------ Enter the name of the program (or drop its icon into the entryfield). Path info isn't needed and will be removed when you add this entry. To disable drag and/or drop for particular window types, uncheck the corresponding boxes. To disable DragText entirely uncheck "All Windows". Press the button labeled "Add". Change a Program's Restrictions ------------------------------- Select the program from the list. The checkboxes will show its current status. Make any necessary changes. Your changes will be saved when you select another program from the list, press the "Apply" button, change notebook pages, or exit. Remove a Program from the List ------------------------------ Select the program from the list. The checkboxes will show its current status. Press the "Remove" button. The entry will be deleted immediately. -- or -- Check all of the checkboxes (i.e. so that there are no restrictions). The entry will be deleted when you close the notebook. __________________________________________________________________________ Disabling DragText System-wide __________________________________________________________________________ DragText uses only documented features of OS/2 which should continue to be supported in future versions. Still, it is possible that unforeseen changes to the operating system will render DragText incompatible with a particular type of window. To retain the bulk of DragText's usefulness, you can disable that window type system-wide. On the Disable page, enter (the angle brackets are required). Uncheck both boxes for this window type, then press the "Add" button. This option will be in effect for all newly launched programs; those which are already running will not be affected. In extraordinary circumstances, you may find it necessary to disable DragText for all new windows in all programs. To do this, follow the instructions above, but uncheck both boxes next to "All Windows". In this case, DragText will be disabled for all new windows, including those created by programs that are already running. Windows that already exist will not be affected. __________________________________________________________________________ Info __________________________________________________________________________ The four Info pages provide information about DragText's usage and current status. They contain no settings except for a place to enter your registration. Info practice your drag and drop using examples of each supported window Icons view each of the icons and pointers used as you drag text and files DLL review usage statistics and error messages DT enter your registration number, review product info __________________________________________________________________________ DLL Info __________________________________________________________________________ The DLL Info page provides usage and error statistics for Drgtxt20.dll. Usage ----- The usage section shows the number of processes (programs) that have loaded Drgtxt20.dll and the number currently using it. The latter figure will usually be at least 3 (two instances of pmshell.exe and DragText.exe itself). Errors ------ This section displays the total number of errors encountered during this session, the ID number of the last process to have an error, and the message associated with that error. When an error occurs, Drgtxt20.dll will notify you if you choose this option on the Basic Features-> Misc page. You can restart DragText.exe and refer to this page to review the error message. Note: These messages are intended for debugging and diagnostic purposes. Except for identifying conflicts with other programs, they are of little use to the user. All errors arise from flaws in DragText, other applications, or the operating system. __________________________________________________________________________ Registration Information __________________________________________________________________________ After you register DragText you will receive a registration number. Enter it on the last page (Info->DT) of the Options Notebook. Enter your name exactly as it appears on your registration notice. Close the notebook, then reopen it to reset your options. __________________________________________________________________________ Workplace Shell Classes ----------------------- __________________________________________________________________________ DragText's WPS Classes __________________________________________________________________________ DragText uses two Workplace Shell classes, DTFile and DTClip, to provide some of its Extended features. Except for the features described below, DragText does not rely on the WPS and operates very well on systems where the WPS is not used. DTFile ------  permits appending text to an existing DragText file without having to open it  assigns DragText files a unique icon that identifies them DTClip ------  provides a drag and drop interface for the clipboard DragText must be loaded and the Extended features provided by these classes must be enabled before you can use them. DTClip and DTFile can be installed or removed at any time, regardless of whether any Extended features are enabled. If your free trial period for the Extended features has expired and you haven't registered DragText, you should remove these classes to save memory. __________________________________________________________________________ DTFile __________________________________________________________________________ Files created by DragText become DTFile objects if this WPS class is installed. Unlike a standard data file, you can drop text or another file on a DTFile's icon to append the new text to the end of the existing text. DragText must be loaded before you can use the append feature. To identify them, DTFile objects share a default icon that doesn't change, regardless of any program associations. You can replace this default icon with another if you wish. For additional information, refer to:  Changing the DTFile Icon  Using DTFile Append  DTFile Append Options __________________________________________________________________________ Changing the DTFile Icon __________________________________________________________________________ To replace DTFile's default icon, create an icon file named MYFILE.ICO and place it in your DragText directory (i.e. the same directory as DTFILE20.DLL). __________________________________________________________________________ Using DTFile Append __________________________________________________________________________ Drop text or a file on a DTFile's icon to add it to the file. The new text will be joined to the existing text according to the append options you select. Refer to DTFile Append Options for a complete description. Important: When dropping text or a file on an object's icon, the mouse pointer and the dragged image will not change the way it would over a DragText-enabled window. However, standard DragText actions, such as pressing Alt to insert a dropped file's contents, will still work. __________________________________________________________________________ DTFile Append Options __________________________________________________________________________ Each DTFile object has two pages in its WPS notebook that control the way text or a file dropped on a DragText file icon will be joined to the existing text. The first page controls options for that file only. The second page sets system-wide options for all DTFile objects. Existing Text ------------- Controls whether any blank space following the existing text will be removed. Null and end-of-file characters will always be removed, regardless of this setting. Your choices are:  remove trailing blank lines - lines containing only spaces, tabs, and newline characters will be deleted. The last line of text will not be affected.  remove trailing whitespace - all spaces, tabs, and newline characters after the last printable character will be deleted. This is the default.  do not edit - the file will be left as-is, except for trailing null and end-of-file characters. Separator --------- Controls what text, if any, should be placed between the file's existing contents and the newly added text. edit window: enter your separator text here exactly as it should appear in the file. Blank lines in the separator will not be removed. If you don't want a separator, erase the entire contents of this window. If this window is too small for your needs, use another editor to format your separator text. Then drag that text (or the file you saved it in) into this window. You can include the date and/or time of the append by entering these meta-characters in your separator text: %d date (same as %D) using your country's standard format %D date (same as %d) using your country's standard format %t time as HH:MM (plus AM or PM if you use a 12-hour clock) %T time as HH:MM:SS (plus AM or PM if you use a 12-hour clock) Separator always on a new line: checking this ensures that the separator always appears on the line following the existing text. It will not add a blank line and will not have any effect if there is no separator. New Text -------- Controls whether any blank space preceeding the new text will be removed. Null characters will always be changed to spaces, regardless of this setting. Your choices are:  remove leading blank lines - lines containing only spaces, tabs, and newline characters will be deleted. The first line containing printable text will not be affected. This is the default.  remove leading whitespace - all spaces, tabs, and newline characters before the first printable character will be deleted.  do not edit - the dropped text will be left as-is, except for leading nulls. New text always on a new line: checking this ensures that the dropped text always appears on the line following the separator or existing text. Otherwise, its position depends on whether the preceeding text ends with a newline character. Undo ---- restore the settings that were in effect when the notebook was first opened Default ------- On the first notebook page ("Options for This File"), resets this file's options to the system-wide defaults. On the second notebook page ("DTFile Defaults"), resets the options to DTFile's built in defaults. When the defaults are already in effect, this button is disabled. __________________________________________________________________________ DTClip __________________________________________________________________________ DTClip provides a drag and drop interface for the clipboard. Registering this class creates a Clipboard Object on the Desktop that operates like a DragText-enabled window. Opening the object displays a window that can be used as a clipboard viewer and editor. The window offers an "always visible" option that keeps it from becoming completely covered by another window. DTClip supports only text, not graphics. DragText must be loaded before you can use this feature. For additional information, refer to:  Using DTClip's Icon  Using DTClip's Window  DTClip as a Clipboard Viewer  Moving and Copying DTClip  Installing and Removing DTClip  DTClip Options __________________________________________________________________________ Using DTClip's Icon __________________________________________________________________________ Drag from the object's icon to drag whatever text is on the clipboard. DragText's standard text or Url icon will appear. If the clipboard is empty or contains graphics, DTClip will beep and nothing will be dragged. Drop text or a file on the object's icon or window to copy it to the clipboard. By default, the new text will replace any existing text. To append the dropped text to the clipboard's existing text, quickly press and release Insert while over the object or window. Important: When dropping text or a file on the object's icon, the mouse pointer and the dragged image will not change the way they would over a DragText-enabled window (e.g. DTClip's own window). However, standard DragText actions, such as pressing Alt to insert a dropped file's contents, will still work. __________________________________________________________________________ Using DTClip's Window __________________________________________________________________________ Drag and Drop ------------- Drag : To drag the current contents of the clipboard, begin dragging without highlighting any text; the window's contents will be updated. To drag a selected portion of the text, highlight it, then begin dragging; the selection will be dragged and the window will not be updated. Drop : Dropped text can either replace the clipboard's current contents or be inserted into it. Quickly press and release the Insert key while dragging over DTClip's window to toggle between insert and replace modes.  In replace mode, the mouse pointer will become DragText's "I-beam with X's" pointer. The dropped text will replace the current contents of both the window and the clipboard.  In insert mode, the dropped text will be inserted into the window's current contents at the drop point. The entire contents of the window will then be copied to the clipboard. Menu Items ---------- Copy All : the current contents of the window will be copied to the clipboard. Use this after editing the text in the window. Paste All : the contents of the clipboard will be pasted into the window, replacing whatever is currently in the window. Use this to update the window. Options : use the items on this submenu to change the default settings established on the Options page of the object's notebook. Refer to DTClip Options for a description of each. __________________________________________________________________________ DTClip as a Clipboard Viewer __________________________________________________________________________ When the clipboard viewer option is on, DTClip's window will be updated automatically whenever the clipboard changes. This option can be set independently for each DTClip window you open without affecting the status of other DTClip windows. Compatibility with Other Viewers -------------------------------- OS/2 supports having only one viewer window at a time. When a new viewer is established, the previous viewer no longer receives update notifications. However, DTClip and some other viewer apps such as ManyClip are designed to work around this restriction by forwarding the notification to the previous viewer. For DTClip, this is controlled by the "cooperate with other viewers" setting on the Options page of DTClip's notebook. When it is checked (the default), DTClip will forward the notification.  OS/2 Clipboard Viewer utility - after starting this util, make DTClip the viewer. It will forward notifications to the viewer util.  ManyClip - ManyClip must always be the primary viewer. If it is already running, click on its window immediately after making DTClip the viewer. This will restore ManyClip as the primary viewer and cause it to forward notifications to DTClip. __________________________________________________________________________ Moving and Copying DTClip __________________________________________________________________________ To copy, move, or shadow the object itself, have Ctrl and/or Shift pressed when you begin to drag. Once DTClip's icon has begun to move, you can release these keys, if desired. You can also move or copy the object by:  using its menu options  selecting other objects to be moved or copied at the same time  performing these actions before DragText is loaded __________________________________________________________________________ Installing and Removing DTClip __________________________________________________________________________ DTClip can be installed or removed either by using the DTSetup program or by opening DragText's Options notebook to the Extended page and pressing the button next to DTClip. Each time you install DTClip, a Desktop object will be created; its WPS ID is "". Removing DTClip will explicitly delete this object. Copies of it will not be deleted and may reappear if you later reinstall DTClip. If you need to recreate the Desktop object (e.g. you accidentally deleted it), simply remove the DTClip class, then install it again. Restarting your system is not necessary. __________________________________________________________________________ DTClip Options __________________________________________________________________________ These options are set from the first page of a DTClip object's WPS notebook. They apply to the window(s) displayed when you open the object. Most are defaults that can be changed for a particular window from its Options submenu. word wrap --------- This can be changed from the Options submenu. keep window visible ------------------- whenever the text area of the window becomes completely covered, it will place itself on top of all other windows. If it is only partially covered, it will not move. This can be changed from the Options submenu. check visibility controls how often the DTClip class should check to see if any of its windows are covered. This is a global setting that affects all windows for all DTClip objects. clipboard viewer ---------------- when enabled, the window will automatically be updated whenever the contents of the clipboard changes. This can be changed from the Options submenu. cooperate with other viewers if another clipboard viewer is active when DTClip becomes the viewer, DTClip will forward update notifications to the previous viewer when they are received. If both DTClip and the other viewer start updating their windows continuously, turn this off. Undo ---- restore the settings that were in effect when the notebook was first opened Default ------- use DTClip's built in default settings. When they are already in effect, this button is disabled. __________________________________________________________________________ About DragText -------------- __________________________________________________________________________ Registration __________________________________________________________________________ To keep DragText's Extended features from becoming disabled after your 6-week free trial ends, register it directly with the author or through BMT Micro. You will receive a registration number to enter on the last page of the Options Notebook. __________________________________________________________________________ Direct - $15 - $20 (US) __________________________________________________________________________ The author can accept checks or money orders drawn in any stable major currency.  U.S. Dollars: registration is $15 if the check is drawn in US dollars on a bank in the United States. Some users in western Europe have successfully sent me cash, but this was done entirely at their own risk.  Other Currencies: registration cost is the equivalent of $20 converted into your national currency. The additional cost covers my bank's fee for automated processing. Your check will not be accepted if it converts to significantly less than $20, or if my bank requires it to be processed manually. You can determine the exchange rate by asking your bank or looking in the financial pages of your local newspaper. There are usually separate "buying" and "selling" rates. Please use the rate that is less favorable to you (i.e. will cost you more) because that is the rate I will get when I cash your check. If you have any questions, email me before sending your payment. Mail your check or money order to: Rich Walsh 315 S. Barbour St. Beverly Hills, Florida 34465 U.S.A. Include your full name, mailing address, and email address (if available). Send email to: rlwalsh@packet.net __________________________________________________________________________ BMT Micro - $18 (US) __________________________________________________________________________ Phone: 8:00am - 7:00pm EST (-5 GMT) (800) 414-4268 (Orders only) (910) 791-7052 (Orders / Order Inquires) Fax: (800) 346-1672 24 hours, 7 days a week (910) 350-2937 24 hours, 7 days a week BBS: (910) 350-8061 10 lines, all 14.4K (910) 799-0923 28.8k v.FC Internet: bmt@wilmington.net Compuserve: Thomas Bradford, 74031,307 telnet: bmt.wilmington.net BMT Micro accepts Visa, Mastercard, Discover, American Express, Diner's Club, money order, cashiers checks, and personal checks. They also accept DM and British currency via registered mail. Personal checks are subject to clearance. BMT Micro accepts purchase orders from educational institutions, governmental agencies and other verifiable businesses. Terms are "Due Upon Receipt" with a $250 minimum. __________________________________________________________________________ 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 require the payment of a registration fee for continued use. You may copy and freely redistribute DragText to others, provided: - the recipient agrees to the terms of this license, - you transfer DragText as a whole and intact, - there is no cost to the recipient other than the costs of providing media and transmission, and - it is not redistributed in conjunction with any software that may not also be freely redistributed by the recipient. 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. * OS/2 and Presentation Manager are trademarks of International Business Machines Corp. __________________________________________________________________________