home *** CD-ROM | disk | FTP | other *** search
Text File | 1996-11-30 | 86.4 KB | 2,220 lines |
-
- __________________________________________________________________________
-
-
-
- - 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 "<http://>www. <ftp://>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 <ALL PROGRAMS> (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 "<DT_CLIP>". 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.
-
-
-
- __________________________________________________________________________
-
-