__________________________________________________________________________
- 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.
__________________________________________________________________________