home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Shareware BBS: WPS_PM
/
WPS_PM.zip
/
drgtx33u.zip
/
DTHelp.Txt
< prev
next >
Wrap
Text File
|
2000-05-01
|
140KB
|
3,508 lines
_______________________________________________________________________
- DragText version 3.3 -
The Drag and Drop Enabler for OS/2*
(C) Copyright R L Walsh 1994 - 2000
All rights reserved.
write to
DragText@E-vertise.com
-- or --
Rich Walsh
315 S. Barbour St
Beverly Hills, Florida 34465
U.S.A.
_______________________________________________________________________
_______________________________________________________________________
DTHelp.Txt - the plain-text version of DragText's online Help.
_______________________________________________________________________
_______________________________________________________________________
Contents
========
Getting Started
Installation / Removal
Running DragText
Frequently Asked Questions
New and Revised Features in Version 3.3
Bugs and Shortcomings
Using DragText
Dragging Text, Files, and Objects
Using Pickup and Drop
Icons and Pointers
Supported PM Windows
VIO Windows
Options Notebook
Basic Pages
File pages
VIO pages
WPS pages
Setup pages
Info pages
Workplace Shell Classes
DTFile
DTClip
DTProgram
About DragText
Registration
License Agreement
Appendix: Feature Summary
Drag
Drop
Related Features
_______________________________________________________________________
_______________________________________________________________________
Getting Started
_______________________________________________________________________
_______________________________________________________________________
Basic Features
DragText's Basic features are offered without charge and require
no registration.
Drag-and-Drop Text - Use drag and drop to copy, move,
or delete the text found in standard edit windows, listboxes,
etc. You can also enter a file's name by dropping its icon
into a window.
DTProgram - DTProgram is a comprehensive enhancement
of the program object class with both general and drag &
drop features. Schedule objects to open automatically, set
environment variables for any program, attach other objects
to your programs, and more.
Extended Features
DragText's Extended features integrate text with files, WPS
objects, and the clipboard, and add support for pickup-and-drop
and VIO (command-line) windows. They are offered as
shareware and require registration for continued use. See the
section on Registration for details.
Files and Urls - Drag text to a Workplace folder to create
a DragText file; it's title will be derived from the text. If
the text is a URL, DT will create a Url object instead.
Drop a DragText file or Url object on any supported window
to insert its text. You can also drop files from any source
on many windows to insert their contents.
Desktop Integration - Get direct access to WPS objects
from almost any program using DragText's powerful WPS
interface. Text Links lets you treat a filename or object ID
like a shadow of the object it names. Window Links makes
any window's System Menu button a shadow of the object
which opened it. Both features let you drag the linked
object, locate it, or use its menu. DT complements these
with Drop to Open: drop an object on any System Menu
button to open it, locate it, or show its menu.
WPS Classes - DragText provides additional WPS services
through the use of two optional classes. DTFile permits you
to append text to an existing DragText file by dropping it on
the file's icon. DTClip offers a drag and drop interface for
the clipboard, plus DTSnip, an editor/viewer for both
clipboard and dragged text.
Pickup and Drop - Any window that lets you drag text also
lets you pick it up so you don't have to keep MB2 pressed.
Because DT copies your text and transfers it to the WPS for
safekeeping, you can edit or close the source window
without affecting your "lazy drag".
VIO windows - Support for VIO windows is also included
with the Extended features. DT can drag text directly from
these windows' video buffers, but it has to use the
clipboard to drop text into them. Full support for
mouse-initiated marking, copying, and pasting is provided
for your convenience.
Compatibility
DragText's features are available in nearly every program, but
not necessarily in every window. (See Supported PM Windows)
It is designed to add its features only to windows which lack
them and should never replace or interfere with the support
provided by your applications unless explicitly instructed to do
so. If a conflict occurs, DragText can be partially or totally
disabled for a specific 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 DrgTxt33.Exe and put it on your
Desktop
install the startup option you selected
offer you the option of installing three Workplace Shell
classes that provide some of DragText's features
insert several entries in os2.ini to disable DragText for
programs known to be incompatible
insert entries in os2.ini to reenable DragText in programs
that override it, and
display some information specific to your system.
If you are upgrading from a previous version, DTSetup will also
transfer its settings and registration info to the new installation.
Removal
To remove DragText from your system, you can either:
run DTSetup from your DragText directory and choose
"Uninstall" to partially or completely remove it, or
open DT's Options notebook to the Setup page and select the
"Manual" Startup option so DragText no longer loads
automatically
DragText's WPS classes can also be installed or removed using
the WPS page of the Options notebook. If you uninstall part or
all of DragText, you will have to restart your system to remove
it from memory if it was previously loaded.
_______________________________________________________________________
Running DragText
_______________________________________________________________________
DragText will be loaded into memory automatically during
boot-up if you choose the Autoload Startup Option. Otherwise, it
will be loaded the first time you run DrgTxt33.Exe, either from
the WPS Startup folder or manually. This first run will display a
copyright message for 3 seconds, and then terminate. Regardless
of how you load it, DragText will remain resident until you
reboot and will not appear in any list of windows or tasks.
All supported windows created AFTER DragText is loaded will
provide drag-and-drop; those created before will not. This is
the primary reason for loading DragText as early as possible
during startup. Using Autoload will ensure that every possible
window is DT-enabled.
Running DrgTxt33.Exe after DT has been loaded will bring up its
Options Notebook which has pages that let you:
set options for the Basic features such as the default drag
action
enable and configure DragText's Extended features (File,
Vio, and WPS features).
Setup DragText's startup and compatibility options
view 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
Command-line Parameter
DragText normally stores its INI file in the same directory as its
EXE. You can override this by specifying another directory as a
command-line parameter. The new path will be saved and used
as the default until changed again. You can also set this path
from the Setup page of DT's Options notebook.
Startup.Cmd
Using Startup.Cmd to load DragText is no longer recommended,
although it continues to work. Instead, use the "autoload during
boot" option available on the notebook's Setup page.
_______________________________________________________________________
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 DrgTxt33.Exe), it stays there until you reboot. (If
you use Pstat or Watchcat, you will see DrgTxt33.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.
You may be able override this behavior and restore DragText
functionality using the Reenable page of DT's Options
notebook.
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 3.1
_______________________________________________________________________
DragText has undergone major internal restructuring to enable
v3.3's primary new features. Minor changes have been made to
some of DragText's other components.
New Features
Reenable - If a program disables or overrides DragText in
a supported window, you can now restore DT's features on
an app-by-app, window-by-window basis, for drag or drop
or both. Default settings reenable edit windows in Netscape
4.x, the latest version of System Editor (e.exe), and several
other apps.
Autoload - Instead of running DrgTxt33.Exe to load
DragText, you can have OS/2 load it automatically during
boot-up. This guarantees that every windowed program will
be DT-enabled. You can turn this option on or off at any
time from DT's Options notebook.
Enhancements
Startup Options - Use the new 'Setup' page in DT's
Options notebook to select the method used to load DT:
Autoload, WPS Startup Folder, or Manually. DragText will
update os2.ini and the Startup folder, creating or deleting
entries and objects as needed - nothing unnecessary will be
left behind.
Text Links - Ctrl-Shift F10 will now display the WPS
menu for a file or object mentioned in text, the same way
that Ctrl-Shift MB2 does. In addition, you can now use a
WPS object's numeric handle to access it. This can be
handy when exploring the content of your os2.ini.
Url Handling - DragText has always been able to rejoin a
Url split across several lines. Now it handles Urls with
embedded email/usenet quote marks (i.e. '>') as well. Just
hilite the entire Url and DT will remove the quotes, spaces,
linefeeds, etc. when you create a Url object.
Options Notebook - The 'Disable' section has been
renamed 'Setup' and has two new pages:
- Setup page - set your startup option, specify the path
for DT's INI file, and create new Desktop objects for
DragText and DTClip.
- Reenable page - specify programs and windows
where DT should reenable itself.
Bugs Fixed
WPS - The WPS would crash or hang due to an access
violation when dragging from a DT-enabled window owned
by the WPS, and dropping on a DTClip or DTFile icon.
Url Handling - Urls containing an embedded right bracket
were truncated at the preceding character.
FileStar - Because FileStar misidentifies dragged files as
Netscape v2.02 Urls (DRM_HSTRSOURCENAME), DT would
omit a file's path when inserting its name in text. DT now
works around this to achieve compatibility with both apps.
Other Changes
Install Path - In order to support Autoload, DragText's
installation path can not contain any spaces.
All Text - Pressing Ctrl when you drag from an MLE,
Listbox, or VIO window drags the entire contents of the
window. If this conflicts with your work habits, you can
disable this feature on the Setup->Fixes page of DT's
Options notebook.
_______________________________________________________________________
Bugs and Shortcomings
_______________________________________________________________________
DTProgram - there are limitations on the Environment
feature, depending on how a program object is used. This
only affects OS/2 programs, not DOS and WinOS/2.
- if you open the object directly, this feature will work
as expected: the WPS will construct an environment
for the program by merging your entries with the global
environment.
- if you drop a file on this object, or open a file
associated with this object, the WPS will only use your
entries and will not construct a complete environment.
This may be a serious problem for some apps but no
problem at all for others. You can work around this by
using substitution variables (e.g. %PATH%) to copy
required values from the global environment.
Window Links and Text Links - some items on a linked
object's popup menu don't work. In particular, none of the
entries on the 'Create Another' submenu work except for the
'Default' entry.
In some versions of Warp 3, a Window Link menu may first
appear in the lower-left corner of the screen before moving
to the proper position.
_______________________________________________________________________
_______________________________________________________________________
Using DragText
_______________________________________________________________________
_______________________________________________________________________
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 a file or Url object in supported
windows
insert a file or WPS object's path in any supported window
create a formatted listing of a folder's directory
append text to existing DragText files
copy text to and from the clipboard
copy, move, or shadow WPS objects by name
copy, move, or shadow WPS objects from the windows they
open
open, locate, or show the menu of any WPS object
For a comprehensive list of DragText's features, see Appendix:
Feature Summary
To help you identify the results from a drag and drop operation,
DragText uses up to nine 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.
Dragging Text, Files, and Objects
Using Pickup and Drop
Icons and Pointers
Supported PM Windows
VIO Windows
Drag and Drop Summary
_______________________________________________________________________
Dragging Text, Files, and Objects
_______________________________________________________________________
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). To drag the entire
contents of a Listbox, MLE, or VIO window without affecting
your current selection, press Ctrl then drag. For single-line
entryfields, begin dragging without highlighting any text.
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
With the Basic features, you can drop a file or object into any
supported window to insert its fully-qualified name (i.e. its
complete path). Shift-drop instead to insert its unqualified
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 an MLE or VIO
window by pressing Alt before you drop it. Alt-drop a folder in
an MLE to insert a formatted listing of its directory. The
formatting is controlled by the settings on the Directories page
(Files->Dirs) of the Options notebook.
Dragging Objects
With Window Links enabled, you can drag the WPS object that
opened a window by dragging from that window's System Menu
button. With Text Links enabled, you can drag objects named in
text. Highlight a filename, an object ID, or an object handle,
press Ctrl-Shift, then drag. In each case, the effect is identical
to dragging this object from its folder. The default drop action
is "create a shadow", but you can change this to Move or Copy
by pressing Shift or Ctrl when you drop the object.
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.
_______________________________________________________________________
Using Pickup and Drop
_______________________________________________________________________
When enabled, windows that let you drag text will let you pick
it up as well by pressing Alt-MB2. After you release the mouse
button, your "lazy drag" will continue until you explicitly drop or
cancel the pickup.
This feature uses the WPS to work around a bug in all versions
of Warp. DragText transfers a copy of your text to the WPS, then
initiates the pickup from there. As a result:
- you can edit or close the source window without affecting the
text you've picked up
- a true 'Move' operation that deletes the original text is not
possible - all drops are copies. Despite this, DT offers 'Move'
as an option to safeguard your pickup. Without it, your pickup
would be canceled rather than dropped if you accidentally pressed
Shift-MB2.
Usage
DragText supports both pickup and drop for text and Urls only.
While it is unable to pick up objects accessed through its WPS
Link features, it does permit you to drop files and objects picked
up using the WPS. See below for details.
Pickup press Alt-MB2 in a DT-enabled window to pickup the
selected text.
press Ctrl-Alt-MB2 in a Listbox, MLE, or VIO window
to pick up the entire contents of the window,
regardless of highlighting.
Drop over a DT-enabled window, press either Ctrl-MB2 or
Shift-MB2; both will insert a copy the text.
over a WPS folder, press either Ctrl or Shift-MB2, or
select either the 'Copy' or 'Move' option from the
folder's menu; any of these will copy the text to a
file.
Cancel press Alt-MB2 over a DT-enabled window or an empty
space in a WPS folder (e.g. the Desktop).
Abort a Drop release Ctrl or Shift before releasing MB2.
Test a Drop to see if a drop is valid, press and hold Ctrl- or
Shift-MB2. The "illegal" pointer will appear if it is
invalid. Release Ctrl or Shift before MB2 to abort the
drop.
Dropping Files and Objects
Dropping a file or object you've picked up using the WPS is
nearly the same as dropping one that was dragged the standard
way.
For objects other than files or folders, DT will always
insert their full path and name, regardless of whether you
use Ctrl or Shift-MB2.
For files, DT will insert whatever it normally does by
default: either the file's fully-qualified name or its contents.
You can use Alt to toggle between 'insert name' and 'insert
contents' but it's tricky!
- press and hold Ctrl-MB2
- now, press Alt as well
- finally, release MB2, then Ctrl-Alt
Options to insert a file's unqualified name or directory entry
are not available.
For folders, DT always inserts the fully-qualified name by
default. You can insert a formatted directory listing instead
by pressing Alt, as described above.
_______________________________________________________________________
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 (not shown here) - 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 a 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].
Locate object - appears when you drag a file or WPS
object over a system menu button. It indicates that
DragText will locate the object and open the folder
containing it.
Open object - appears when dragging a file or WPS
object over a system menu button (you must press the
Alt key). If you drop it, DragText will open the object.
Show object's menu - press Ctrl while dragging a
file or WPS object over a system menu button. If you
drop it, DragText will display the object's popup menu.
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.
_______________________________________________________________________
Supported PM Windows
_______________________________________________________________________
DragText works with seven 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 Directories for
details).
drag all of the window's text without affecting the current
selection by pressing Ctrl when you drag
Listbox
When you drag from a listbox, DT creates a list of the selected
items with a newline between each entry. Press Ctrl first to
drag a list of every item.
DT splits dropped text into lines, then searches for a matching
entry for each line. With single-selection listboxes, it stops
after selecting the first match. In multiple selection listboxes,
it selects every matching item. If no match is found, you'll hear
a beep.
DragText will never insert or delete text in 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, as described above.
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.
System Menu Button
the menu button at the left end of most titlebars can be used as
a link to the WPS object that opened this window. You can drag
the linked object or click MB2 to show its menu. When viewing
files, you can also Ctrl-drag or Ctrl-click to access the viewer
program's object.
Titlebar
drop text here to transfer it to a DTClip window
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.
When you drag text from a VIO window, DragText will read the
selected text directly from the screen. However, it will have to
use the clipboard to drop text into these windows. This is the
only instance where DragText uses 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. To drag
the entire content of a VIO window, don't highlight anything,
just press Ctrl, then drag.
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 Files->Other
Files page in DragText's Options notebook.
_______________________________________________________________________
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 VIO
page in DragText's Options notebook.
_______________________________________________________________________
Mouse Marking in VIO Windows
_______________________________________________________________________
DragText provides a mouse-initiated marking feature which
operates like 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 Vio->Mouse
Marking 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. Use the Vio page of DragText's
Options notebook to set VIO support on or off by default for new
windows. Then, override the default for a particular window
from the 'DragText' item in its System Menu
_______________________________________________________________________
_______________________________________________________________________
Options Notebook
_______________________________________________________________________
_______________________________________________________________________
Whenever you need to change DragText's defaults or get help on
using it, run DragText to open its Options Notebook. There are
six major sections:
Basic set the default actions for DragText's Basic features.
Files set options related to files, folders, and Urls
Vio control DragText's operation in command-line
windows
WPS install DT's WPS classes and and enable its WPS
features
Setup configure DragText's startup and compatibility
options
Info get quick help, review error messages, enter your
registration
All settings take effect as soon as you close the notebook,
change to another page, or press the "Apply" button.
_______________________________________________________________________
Basic Pages
_______________________________________________________________________
The three Basic pages let you set the default actions for
DragText's Basic features which are available for all users.
Basic
Drag Defaults should DragText move or copy text
Drop Options enable some handy options
Miscellaneous
Background Drag drag from a window without bringing it
to the top
Other Options set DT's mouse pointer size; enable
DT's distinctive error notification
Style
Set Colors set colors for the notebook pages using
drag and drop
Contents Window control its appearance
Size / Position options that affect the notebook's
location
All settings take effect as soon as you close the notebook,
change to another page, or press the "Apply" button.
_______________________________________________________________________
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) when you drop.
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.
_______________________________________________________________________
Drop 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.
Entryfield Text
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
_______________________________________________________________________
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:
disabled
enabled
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.
_______________________________________________________________________
Other Options
_______________________________________________________________________
Mouse 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.
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 messages can be viewed on
the DLL Info page.
_______________________________________________________________________
Set Colors
_______________________________________________________________________
Choose a color scheme for the notebook using drag and drop.
Open a color pallete (usually in the System Setup folder), then
drag a color to this area. To set a background color, just drop
it. To set text color, press Ctrl, then drop. Set the Contents
window's colors and fonts by dropping them directly onto it.
Default Schemes
Color: restores the default color scheme
Gray: sets the colors to gray backgrounds and dark blue
text
_______________________________________________________________________
Contents Window
_______________________________________________________________________
Save on Exit
When checked, DragText will save the state of the Contents
window when you close the notebook. When you reopen it, the
last page you accessed will be restored.
Icons and Lines
These allow you to display or hide the Contents window's icons
and lines.
_______________________________________________________________________
Size / Position
_______________________________________________________________________
Save on Exit
When checked, DragText will save the notebook's size and
position when you close it, and will restore these values when
you reopen it.
Save Now
If you'd prefer to open the notebook with a fixed size and
position, adjust it accordingly, then press 'Save Now'. Don't
forget to turn off 'Save on Exit'.
Restore Default Size
Reset the notebook to its original size.
_______________________________________________________________________
File pages
_______________________________________________________________________
Options on the six Files pages control DragText's handling of
files, folders, and Url objects.
Files
enable file and Url handling and set filename formatting
DragText Files
should DT move or copy text when creating or reading DT
files
Other Files
what should DT insert when you drop non-DT files
Urls
customize DragText's handling of Urls
Directories
filter and format DragText's directory listing options
Temporary Files
should DT create a temporary file whenever you begin a
drag
All settings take effect as soon as you close the notebook,
change to another page, or press the "Apply" button.
_______________________________________________________________________
Files
_______________________________________________________________________
DragText's Extended features let you create and read files and
Url objects using drag and drop. The Files page offers some
primary options for these features:
Enable Extended Features - enable file and Url handling
File and Url Titles - set filename formatting
_______________________________________________________________________
Enable Extended Features
_______________________________________________________________________
Enable DragText's file and Url handling features systemwide.
Files
create: drop text on a folder or the Desktop to create a
file whose name is taken from the text
read: drop files and Url objects on windows and objects to
insert their contents
disable: turn off these features system-wide from here, or
disable them 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.
_______________________________________________________________________
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)
Codepage Support
controls how DragText decides if a character is a letter, number,
or punctuation when creating file titles. Leave this set to
standard unless you switch between incompatible copdepages.
standard: if DT supports your codepage, it will use a
built-in list of alphanumeric characters; otherwise, it will
use the generic method.
ASCII: only letters from the ASCII character set will be
used (A-Z, a-z). Accented characters and characters from
non-Latin alphabets will be removed.
generic: DT will assume that characters which have both
an upper and lowercase form are letters.
DragText supports these alphabets and codepages:
Latin: 437, 819, 850, 852, 1004
Greek: 813, 869
Cyrillic: 866, 878, 915
Hebrew: 862, 916
_______________________________________________________________________
DT 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.
_______________________________________________________________________
Urls
_______________________________________________________________________
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 most
OS/2 Web browsers to load the Url.
Url Identifiers the prefixes DragText will recognize as URLs
Title Options create objects with meaningful names
_______________________________________________________________________
Url Identifiers
_______________________________________________________________________
When the beginning of your text matches one of these prefixes,
DragText creates a Url object. The default values are: http://
ftp:// https://
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.
_______________________________________________________________________
Directories
_______________________________________________________________________
To insert a formatted listing of the files in a directory, drag a
Workplace folder to a multiline entryfield, then drop it while
pressing Alt. This listing will not include non-file objects (such
as program objects or shadows). This feature can be used to
create simple command scripts, as shown in the Examples.
Include select the files and directories listed
Formating control how paths, filenames and dates are
formatted
Meta-characters the characters used to represent names, dates,
etc.
Examples creating a verbose listing and creating a
command file
_______________________________________________________________________
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
_______________________________________________________________________
Heading and Listing Format
_______________________________________________________________________
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
(followed by a carriage return) is: %# %d %t %s %a %f
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
_______________________________________________________________________
Examples
_______________________________________________________________________
Example 1 - verbose listing
[Heading] Directory listing for %p
[Listing] File %F was created on %d at %T
[Output] Directory listing for C:\DrgTxt33
File DRGTXT33.EXE was created on 04-22-00 at 03:30:00
File DRGTXT33.DLL was created on 04-22-00 at 03:30:00
[etc.]
Example 2 - creating a command file
[Heading] cd %p
[Listing] ren %f %F
[Output] cd C:\DrgTxt33
ren DrgTxt33.Exe DRGTXT33.EXE
ren DrgTxt33.Dll DRGTXT33.DLL
[etc.]
_______________________________________________________________________
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 DrgTxt33.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.
_______________________________________________________________________
VIO pages
_______________________________________________________________________
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
Vio
enable command line window support systemwide; set
defaults for newly opened Vio windows
Mouse Marking
enable DT's text-marking feature and control its operation
_______________________________________________________________________
Vio
_______________________________________________________________________
Enable Extended Feature
Drag and drop text into VIO (OS/2 and DOS command line)
windows. For drags, DragText reads the selected text directly
from the screen. For drops, it uses the clipboard to paste the
text. To make marking VIO text easier, DragText offers a
mouse-initiated marking feature similar to Warp v4.0 but more
flexible.
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.
_______________________________________________________________________
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. Your
choices are:
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.
_______________________________________________________________________
WPS pages
_______________________________________________________________________
DragText provides three Workplace Shell classes, DTFile,
DTClip, and DTProgram, plus WPS-integration features that
operate independently of any class.
DTProgram is a Basic (free) feature of DragText and is always
enabled. The remainder are Extended features that require
registration for continued use. The WPS classes can be
installed or removed at any time, regardless of registration
status.
WPS
Install/Remove install DragText's WPS classes
Enable Classes enable the WPS classes' features
Window Links
link windows to the objects that opened them
Text Links
link to files and objects named in text
Drop to Open
perform standard WPS actions using drag and drop
Pickup and Drop
drag text without having to keep MB2 pressed
_______________________________________________________________________
Install/Remove Workplace Classes
_______________________________________________________________________
When you turn to the WPS 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 to have existing program
objects and DragText files acquire the new features provided by
DTProgram and DTFile. This should not be necessary for
DTClip. Also, be sure the features provided by these classes are
enabled (see Enable WPS Classes).
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 the required DLLs could not be
found in your DragText directory (all of DragText's program files
must be in the same directory as DrgTxt33.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. You may have to restart your system to remove
DTProgram and DTFile from memory.
_______________________________________________________________________
Enable WPS Classes
_______________________________________________________________________
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.
Recreating the Clipboard Object
If you need to recreate your Clipboard Object (perhaps because
you accidentally deleted it), turn to the Setup page of the
notebook, then click on the 'DTClip' button toward the bottom of
the page.
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.
_______________________________________________________________________
Window Links
_______________________________________________________________________
This feature lets you use a window's System Menu button as if
it were a shadow of the object which opened the window. You
can drag the original object or display its menu.
Drag linked object
When enabled, Ctrl-Shift drag from a window's System Menu
button to drag the object which opened that window. The effect
is identical to dragging the object from its WPS folder, except
that the default drop operation is "create a shadow".
Show object's menu
When enabled, clicking MB2 (the drag button) on a window's
System Menu button will display the menu of the object that
opened the window. The first item on this menu is the object's
title; selecting it will locate the object and open the folder it's
in.
When you open a file, the menu that appear's belongs to the file
object. To display the menu for the program being used to view
the file, press and hold Ctrl while clicking MB2.
Notes
DragText does not provide menus for windows that are
owned by the WPS, such as folders or notebooks.
Some menu items don't work when using a Window Link
menu; in particular, any of the 'Create another' choices
except "Default".
Window links does not work with open URL objects due to a
bug in the WPUrl class.
_______________________________________________________________________
Text Links
_______________________________________________________________________
This feature provides instant access to WPS objects directly
from text. You can highlight a filename, an object ID, or an
object handle, then drag the named object or show its menu.
Drag linked object
When enabled, Ctrl-Shift drag a filename or object ID to drag the
named object. The effect is identical to dragging the object
from its WPS folder, except that the default drop operation is
"create a shadow".
Show object's menu
When enabled, press Ctrl-Shift, then click MB2 (the drag button)
on a filename or object ID to display the named object's menu.
The first item on this menu is the object's title; selecting it
will locate the object and open the folder it's in.
Search Paths
Text Links should always work with fully-qualified filenames
(i.e. names that include a drive and directory), valid object IDs
(e.g. <WP_DESKTOP>) and object handles (e.g. "34C9B"), and
entries in File Open/Save dialogs.
For filenames that aren't fully-qualified, DragText first searches
the directories listed in the edit window, then for most files,
the directories included in your PATH statement.
Edit Window
Add paths to frequently accessed files and directories that don't
already appear in your config.sys's PATH statement. The default
DT search path includes the current directory, its parent, the
root directory of your boot drive, and the root directories of your
other fixed disks. You can remove some of these, but leave the
reference to your boot drive in place to avoid undesireable
results (e.g. opening the wrong copy of config.sys).
search LIBPATH for DLLs
If this is checked (and Extended features are enabled), DragText
will use the LIBPATH in your config.sys for dll files. To do so,
DT has to open and read config.sys when it loads. If this
causes problems, uncheck this option; otherwise leave it
checked.
Note: Object handles are the numeric identifiers the WPS uses
internally to track objects. They appear in the 'Key' or 'Value'
fields for many entries in os2.ini and os2sys.ini. If your ini
editor is DT-enabled, you can use Text Links to identify the
object a given entry refers to.
Default
Resets DT's search path and rereads LIBPATH from config.sys.
Apply
Puts any changes into effect immediately and rereads LIBPATH
from config.sys.
_______________________________________________________________________
Drop to Open
_______________________________________________________________________
Drop to Open
This feature lets you use drag and drop to perform standard WPS
actions. When enabled, you can drop an object on any window's
system menu button (at the left end of most titlebars) to:
Keys
pressed Action
none open the folder containing the object
Alt open the object in its default view
Ctrl-Shift display the object's WPS menu
Default Drop Action
Select the default (no keys pressed) action when you drop any
object except a folder on a system menu button:
Locate object: open the folder containing the object
Open object: open the object in its default view
You can override the default by pressing Alt when you drop. You
can also display an object's WPS menu by pressing Ctrl when
you drop, but you can not make this the default action.
_______________________________________________________________________
Pickup and Drop
_______________________________________________________________________
Pickup text
When enabled, windows that let you drag text will let you pick
it up as well by pressing Alt-MB2. After you release the mouse
button, your "lazy drag" will continue until you explicitly drop or
cancel the pickup.
This feature uses the WPS to work around a bug in all versions
of Warp. DragText transfers a copy of your text to the WPS, then
initiates the pickup from there. As a result:
- you can edit or close the source window without affecting the
text you've picked up
- a true 'Move' operation that deletes the original text is not
possible - all drops are copies. Despite this, DT offers 'Move'
as an option to safeguard your pickup. Without it, your pickup
would be canceled rather than dropped if you accidentally pressed
Shift-MB2.
Usage
DragText supports both pickup and drop for text and Urls only.
While it is unable to pick up objects accessed through its WPS
Link features, it does permit you to drop files and objects picked
up using the WPS. See below for details.
Pickup press Alt-MB2 in DT-enabled window to pickup the
selected text.
press Ctrl-Alt-MB2 in a Listbox, MLE, or VIO window
to pick up the entire contents of the window,
regardless of highlighting.
Drop over a DT-enabled window, press either Ctrl-MB2 or
Shift-MB2; both will insert a copy the text.
over a WPS folder, press either Ctrl or Shift-MB2, or
select either the 'Copy' or 'Move' option from the
folder's menu; any of these will copy the text to a
file,
Cancel press Alt-MB2 over a DT-enabled window or an empty
space in a WPS folder (e.g. the Desktop).
Abort a Drop release Ctrl or Shift before releasing MB2.
Test a Drop to see if a drop is valid, press and hold Ctrl- or
Shift-MB2. The "illegal" pointer will appear if it is
invalid. Release Ctrl or Shift before MB2 to abort the
drop.
Dropping Files and Objects
Dropping a file or object you've picked up using the WPS is
nearly the same as dropping one that was dragged the standard
way.
For objects other than files or folders, DT will always
insert their full path and name, regardless of whether you
use Ctrl or Shift-MB2.
For files, DT will insert whatever it normally does by
default: either the file's fully-qualified name or its contents.
You can use Alt to toggle between 'insert name' and 'insert
contents' but it's tricky!
- press and hold Ctrl-MB2
- now, press Alt as well
- finally, release MB2, then Ctrl-Alt
Options to insert a file's unqualified name or directory entry
are not available.
For folders, DT always inserts the fully-qualified name by
default. You can insert a formatted directory listing instead
by pressing Alt, as described above.
_______________________________________________________________________
Setup pages
_______________________________________________________________________
The Setup pages let you configure DragText's startup and
compatibility options:
Setup
Startup Options choose how and when DragText will
be loaded
Ini Path select an alternate location for DT's
ini file
Create Desktop Objects recreate your DragText and DTClip
icons
Compatibility
Conflicts with
Other Programs when they say "RTFM", they mean
this page
Disable disable part or all of DragText for a
particular program
Reenable restore DragText's control of drag
and drop in supported windows
Fixes Most users will never need to change
these settings.
_______________________________________________________________________
Startup Options
_______________________________________________________________________
Every time you reboot, DragText's primary dll, DrgTxt33.Dll, has
to be reloaded before it can begin providing its services. The
Startup Options control how, when, and if this will happen.
Changing your current Startup Option may cause DragText to
update SYS_DLLS->LoadPerProcess in os2.ini and/or create or
delete a program object in your WPS Startup folder. Using
Startup Options ensures that unneeded entries and objects are
deleted.
manually
DragText will load the first time you run DrgTxt33.Exe or
open its Desktop program object. You can do this at any
time - or not at all. Windows already open will never be
DT-enabled while new ones will be. Selecting this option
removes DT's entry from os2.ini and deletes its object from
the Startup folder.
WPS Startup folder
DragText will create a program object in your WPS Startup
Folder so that DT loads shortly after the WPS starts up.
This option lets you DT-enable almost all of your programs
while still providing an easy way to keep DragText from
loading: delete its startup object. Selecting this option
removes DT's entry from os2.ini and creates an object in
the Startup folder.
autoload during boot
DragText will put an entry in os2.ini that causes the shell
(pmshell.exe) to load DrgTxt33.Dll automatically shortly after
the screen enters graphics mode. This option ensures that
every possible window is DT-enabled. It also provides the
greatest likelihood of compatibility with other system
enhancements and with future versions of OS/2. Selecting
this option adds DT's entry to os2.ini and deletes its object
from the Startup folder.
Note: When you load DragText using its exe, you can prevent it
from installing its features by pressing and holding Ctrl+Shift
while it starts up. DragText's Options notebook will open but
most settings will have no effect. You can still use the
notebook to remove DT's WPS classes, change your Startup
option, etc. Closing the notebook will completely remove
DragText from memory.
_______________________________________________________________________
Ini Path
_______________________________________________________________________
By default, DragText keeps its ini file in the same directory as
its exe and dll files. If this causes problems on your system
(e.g. you don't have write-access to this directory), you can
specify a different one.
The Current path shows the location of the ini file that the
notebook is using now. The New path you enter here will be
stored in os2.ini and used the next time you run DT. Entering
your DragText directory, or simply erasing this field's current
contents restores the default and erases the entry in os2.ini. If
you press the 'Apply' button before you leave this page, you will
be able to see whether DragText accepted your change or
restored the default.
Note: Whenever you run DT, you can also use a command-line
parameter to specify a new ini path. The effect is identical to
setting it here: the path is stored in os2.ini and used regardless
of whether you continue specify it as a parameter.
_______________________________________________________________________
Create Desktop Objects
_______________________________________________________________________
These buttons will create or recreate DragText's standard
Desktop icons.
DragText
creates a program object for DragText whose object ID is
<DT_DESKTOP>. It is independent of the object that DT
may create or delete in your WPS Startup folder
(<DT_STARTUP>).
DTClip
creates an object of the DTClip WPS class whose object ID
is <DT_CLIP>. To move or copy this object, press Shift or
Ctrl before you begin dragging. After the drag has started,
you can release the key.
_______________________________________________________________________
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 may interfere with
an application, or in some cases, the application may interfere
with DragText.
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.
One way to eliminate this problem is to use the Disable page to
disable part or all of DragText 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 drag or only drop for
that window will solve the problem.
A less obvious solution to conflicts may be the Reenable page.
This lets DragText preempt an application's native drag and/or
drop so it can provide these features. Because DragText handles
everything itself, the application never gets involved, eliminating
the conflict.
Unfortunately, some conflicts cannot be avoided. After a drag
begins, the source window has no control over where the object
can be dropped. This is controlled entirely by the target
window. If the target thinks it can handle the object, it will
accept it. Because the target has no reliable way to identify
which program owns the source window, it can't accept drops
from some programs but refuse them from others. In other
words, you can only disable the things that DragText controls:
your ability to drag from and drop into particular windows,
without regard for where the dragged object came from or is
going to.
The Disable and Reenable lists are checked when a program is
launched, not during its execution. If you need to add or revise
settings for a running program, close it, make your updates, then
restart the program.
Note: Many error messages arise from other problems in the
system and are not directly the result of a conflict between
DragText and your application program.
_______________________________________________________________________
Disable
_______________________________________________________________________
Normally, DragText is enabled for all Presentation Manager-based
(i.e. GUI) programs. However, if it conflicts with an
application's use of drag-and-drop, you can partially or totally
disable DragText for that program.
You cannot disable DragText 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 System Menu Options in VIO Windows for
details).
Program
The "Program" section of the dialog contains a list of all
applications that have restrictions. To add a program, enter its
name or drop its icon into the entryfield. Path information is
not needed and will be removed when you add this entry.
Disable
All of the window-types and features which can be disabled for
a selected program appear here. Initially, none of them are
disabled. Check one or more boxes to partially or completely
disable DragText for this application.
Add / Remove button
When you select a program from the list, this button displays the
word "Remove". Press it to delete the entry and reenable all
DragText features for this program.
When you add a new program to the list, the button changes to
"Add". You must check at least one of the window or feature
checkboxes before you can push it and add this program to the
list.
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.
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 your web browser
from accepting it because DragText does not control the
browser's drag and drop features.
_______________________________________________________________________
Disabling DragText System-wide
_______________________________________________________________________
DragText should continue to be supported in future versions of
OS/2. 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.
_______________________________________________________________________
Reenable
_______________________________________________________________________
When DragText interferes with a program, use the Disable page.
When a program interferes with DragText, use this page to
reenable DragText's features.
Reenable is intended primarily for use with programs that
disable DragText but add no drag and drop features of their own
(e.g. the version of System Editor (e.exe) included in Warp v4.5).
It can also be used in cases where you would prefer to use
DragText rather than the program's native drag and drop (e.g.
some editors and emailers). In some instances, using Reenable
will resolve a conflict between DT and the host program that
Disable can't fix (e.g. NewsReader/2).
Reenable is a powerful feature but it adds some overhead and
complexity to reenabled windows. It should only be used where
it is actually needed, and not for every window in every
program. It only works in supported windows and can not add
DT's features to other types of windows.
Program
The "Program" section of the dialog contains a list of
applications that require this feature. To add a program, enter
its name or drop its icon into the entryfield. Path information
is not needed and will be removed when you add this entry.
Reenable
All of the window-types which can be reenabled for a selected
program appear here. Initially, none of them are reenabled.
Choose only the windows that clearly require this feature for
DragText to work properly. The most likely selection is
"Multi-line EFs", since programs often modify these editor
windows.
Add / Remove button
When you select a program from the list, this button displays the
word "Remove". Press it to delete the entry and remove
DragText's special handling for this program.
When you add a new program to the list, the button changes to
"Add". It will be disabled until you check at least one of the
window checkboxes. Your new entry will not be saved until you
press this button.
Notes:
Reenable settings are checked when a program is launched,
not during its execution. To add or change a setting, close
the application program, update this page, then restart the
program.
Only programs with reenabled windows are saved. Programs
whose settings match the default (nothing checked) will be
dropped from the list.
_______________________________________________________________________
Fixes
_______________________________________________________________________
Most users will never need to change these settings.
Startup Delay use if the WPS hangs at startup
Icons control DragText's icon handling
Misc disable two other features:
file-handling in VIO windows, and
DT's 'All Text' function (i.e. Ctrl-drag)
_______________________________________________________________________
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.
_______________________________________________________________________
Icons
_______________________________________________________________________
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
any available Warp v3 fixpack. It is also fixed Warp in v4.x.
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.
_______________________________________________________________________
Misc
_______________________________________________________________________
VIO file handling
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. This setting is here solely for completeness;
it has no known use.
All Text
Pressing Ctrl when you drag from an MLE, Listbox, or VIO
window will drag the entire contents of the window. If this
interferes with your work habits, you can disable this feature.
_______________________________________________________________________
Info pages
_______________________________________________________________________
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
DragText
enter your registration number, review product info
_______________________________________________________________________
DLL Info
_______________________________________________________________________
The DLL Info page provides usage and error statistics for
Drgtxt33.Dll.
Usage
The usage section shows the number of processes (programs)
that have loaded Drgtxt33.Dll and the number currently using it.
The latter figure will usually be at least 3 (two instances of
pmshell.exe and DrgTxt33.Exe itself).
Errors
This section displays the total number of errors encountered
during this session and the ID number of the last process to
have an error. The text window displays the last 16 error
messages in reverse order, with the most recent message first.
When an error occurs, Drgtxt33.Dll will notify you if you choose
this option on the Basic Features-> Misc page. You can restart
DrgTxt33.Exe and refer to this page to review the error message.
Note: None of these error messages are directly caused by user
action. Rather, they report failures in DragText, other
applications, or the operating system. A few of them may help
you identify conflicts with other programs, but most are
meaningful only to the author.
_______________________________________________________________________
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 uses three Workplace Shell classes, DTFile, DTClip,
and DTProgram to provide additional features.
DTFile
lets you append text to an existing DragText file without
having to open it
assigns DragText files a unique icon that identifies them
DTClip
collect text from various sources in DTClip's editor
windows by dropping the text on a titlebar or copying it to
the clipboard
use its icon as a drag and drop interface for the clipboard
DTProgram
a comprehensive enhancement of the WPS's Program Object
class that offers both general-purpose and drag-and-drop
features
DTProgram is a Basic feature of DragText; its enhancements
are always enabled, even if DragText hasn't been loaded. DTClip
and DTFile are Extended features that require registration for
continued use. DragText must be loaded before you can use them.
All three classes can be installed or removed at any time,
regardless of registration status. If your free trial period for the
Extended features has expired and you haven't registered
DragText, you should remove DTFile and DTClip to avoid
unnecessary system overhead.
_______________________________________________________________________
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 DTFile33.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's icon provides a drag and drop interface for the
clipboard, while its windows provides a "staging area" for your
text handling. Collect text from various sources in a DTClip
viewer window by dropping it on a titlebar or copying it to the
clipboard, then edit and reuse it. New text can be appended
before or after existing text, with an optional separator in
between.
The Options and Append pages in each object's WPS notebook
control the default settings for any windows it opens. Most of
these can be changed for a window once it is open. 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
Notebook - Options page
Notebook - Append page
_______________________________________________________________________
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
_______________________________________________________________________
Each DTClip viewer window operates independently once it is
open; you can change its settings without affecting the object or
other windows. This lets you use one object to open multiple
windows and assign a different function to each. Alternately,
you can create multiple DTClip objects with different default
settings.
Edit Window
Text dropped on a titlebar and/or copied to the clipboard will
appear in this window if the appropriate viewers are enabled. It
can be inserted before or after existing text, at the cursor, or it
can replace existing text. If enabled, a separator will be
inserted whenever new text is appended to old. The new text
(but not the separator) will be highlighted so you can
immediately drag it from the window.
Menu
All options which can be changed for this window appear on the
menu. Any changes made affect only this window. See Notebook
- Options page and Notebook - Append page for descriptions of
these options.
Status bar
This is an active status bar which lets you click on an item to
change the setting it displays. The status bar also provides
buttons to Clear (erase) the window, and to Paste-append the
contents of the clipboard.
_______________________________________________________________________
DTClip as a Clipboard Viewer
_______________________________________________________________________
When a DTClip window's clipboard viewer option is on, it 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 WPS
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.
_______________________________________________________________________
Notebook - Options page
_______________________________________________________________________
Most of these options control the default attributes for this
object's windows and can be changed once a window is open.
Titlebar drops
When enabled, this object's windows will act as DTSnip
viewers: text and files dropped on a titlebar will be inserted in
its windows. This attribute can be changed for any open
window.
open viewer when needed
If titlebar drops are enabled, the object will automatically open a
DTSnip viewer if one isn't open.
Clipboard
When enabled, this object's windows will act as clipboard
viewers: text copied to the clipboard will be inserted in its
windows. This attribute can be changed for any open window.
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.
window visibility
Keeps DTClip's windows from getting lost by ensuring that at
least a portion of the window's text area is visible:
float: the window will check its visibility periodically and
will move itself to the top if its text area is completely
covered.
rise: the window will check its visibility whenever text is
inserted, rising to the top if needed.
normal: the window will not check whether it is visible
word wrap
when enabled, no line of text will exceed the width of the
window
paste on open
when enabled, the contents of the clipboard will be pasted into
every viewer window when it opens, regardless of the clipboard
viewer setting.
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.
_______________________________________________________________________
Notebook - Append page
_______________________________________________________________________
Except for the separator text, these options control the default
attributes for this object's windows and can be changed once a
window is open.
Viewer text
When new text is sent to a viewer window, how should it be
handled?
insert after existing text
insert at cursor
insert before existing text
replace existing text
Dropped text
When text is dropped directly on a viewer window, how should
it be handled?
handle like viewer text - the 'Viewer text' setting will
control how dropped text is inserted
insert normally - text will be inserted wherever you drop
it
Separator
DTClip can insert one of several separators between old and new
viewer text. If the window is empty or set to "replace existing
text" the separator will not be used. Your choices are:
insert text separator (the contents of edit window below
will be used)
insert blank line
insert line break
no separator
Edit window
The contents of this edit window will be placed between old and
new viewer text if 'insert text separator' is enabled. All
windows opened by this object share this separator.
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.
_______________________________________________________________________
DTProgram
_______________________________________________________________________
DTProgram is a Basic (free) feature of DragText that extends the
WPS's Program Object class (WPProgram). Most of its
general-purpose and drag-and-drop enhancements are alway
available and do not require DragText to be loaded. You can
install or remove DTProgram at any time by pushing a button on
the WPS page of DragText's Option notebook, or by running
DTSetup.Exe.
With DTProgram installed, you can:
add or modify environment variables for this program
schedule programs for one-time or repeated execution
add WPS objects to its Objects submenu for easy access;
the program and working directories appear by default
start multiple copies of a program without changing settings
open multiple files in a single copy of a program
use a drag & drop history list to reopen recently dropped
files
drop text on the object to open it with the text as a startup
parameter
use REXX to "drop" a file or text on the object
close or kill programs from the icon that started them
These features are described in detail in the following sections:
Notebook pages
Environment Page
Schedule Page
Objects Page
Options Page
Menus
Open As submenu
Objects submenu
Close All menu item
Drag and Drop
Dropping Text on an Object
Dropping Multiple Files
REXX
Setup Strings
_______________________________________________________________________
Environment Page
_______________________________________________________________________
This page has two separate uses, one for OS/2 programs and
another for DOS and WinOS/2 programs. See "Release Notes"
for important limitations on this feature when used with with
OS/2 programs.
For OS/2 programs, it lets you customize the environment
established by the SET statements in config.sys. You can add
new strings and modify existing ones. You cannot delete
existing variables, but you can usually get the same effect by
setting them to some meaningless value.
For DOS and WinOS/2 programs, it displays the non-default
values set using the 'DOS Properties' or 'WinOS/2 Properties'
button on the notebook's Session page. You can use this to copy
settings from one object to another. Environment variables for
DOS and WinOS/2 should be set in autoexec.bat; they cannot be
set here.
Add or Modify Environment Strings
Enter strings in the edit window, one per line. Each must be in
the form 'VARIABLE=value' (e.g. TEMP=C:\MYAPP\TEMP). The
'SET' command that you would use elsewhere is not needed and
will be removed. You can use substitution variables to merge
new entries with existing variables. For example,
"PATH=c:\drgtxt33;%PATH%".
Whenever you move the focus away from the edit window,
DTProgram will examine each line and modify it, if necessary,
to avoid invalid entries. For example, if you enter the word
'HELLO' all by itself, DTProgram will change it to '?=HELLO'.
'HELLO=' will be changed to 'HELLO=?'.
Note: In some cases, changing an existing variable may have
no effect. For example, OS/2's online help system uses
Presentation Manager's environment, not this program's, so
changing the 'HELP=' path does nothing.
_______________________________________________________________________
Schedule Page
_______________________________________________________________________
Schedule this object to open automatically, either one time or on
a regular basis.
Open on Schedule
When checked, the object is scheduled to open at the date and
time shown. This box must be unchecked to change any of the
options on this page.
Date and Time
Shows when the object will next open. These fields will be
updated automatically if the 'Repeat' option is set. To schedule
this object, enter a date and time that is at least 20 seconds in
the future.
Repeat
When checked, this object will be rescheduled every time it
opens automatically.
Interval
Determines how often the object will be reopened. This can be
specified as a fixed interval, or as a daily, weekly or monthly
event.
after: a fixed interval (1 second - 366 days)
on the: numbered day of the month (1 to 31). Objects
scheduled for the 29th, 30th, or 31st will be opened on the
last day of the month when necessary.
every: day, weekday, weekend day, day of the week, or
week
first: day of the month that meets the criterion
last: day of the month that meets the criterion
Skip if open
When checked, the object will not be opened if it is already
open. If unchecked, the results depend on the object's default
open action: either the open view will be surfaced or a new
view will be opened.
Skip if late
If this object is scheduled to open while your system is off,
DTProgram can either open it when the WPS starts (unchecked)
or can skip it (checked). In either case, the object will return to
its normal schedule if the 'Repeat' option is on.
Undo
Restores the settings in effect when you opened this object's
notebook.
Now
Sets Date and Time to the current time plus 30 to 90 seconds.
Next
Adds the current repeat interval to Date and Time.
Note: DTProgram keeps scheduling records in os2.ini that
should not be changed. If they do not match the info stored by
the scheduled objects, the record will be discarded and the
object will not be opened.
_______________________________________________________________________
Objects Page
_______________________________________________________________________
Add and delete entries on the Objects submenu.
Add up to 8 WPS objects of any kind by dropping them on the
listbox. You can also enter an Object ID (e.g. <WP_SYSED>) or
the full path of any file or directory, then press 'Add'.
Add
Adds the object whose name or Object ID was entered. If the
object cannot be found or is already on the list, the entry will be
ignored. The 'Add' button has no effect when you drop an object
on the listbox.
Delete
Deletes the currently selected object from the listbox.
Undo
Restores the settings in effect when you opened this object's
notebook.
_______________________________________________________________________
Options Page
_______________________________________________________________________
Object ID
Object IDs are names that can be assigned to objects to uniquely
identify them. These names are always surrounded by angle
brackets, for example <WP_SYSED> Assigning an object ID can
be useful if you want to manipulate an object using REXX.
The entryfield lets you view and edit the object's ID. The 'Set'
button puts your changes into effect. You will be warned if the
object's new ID is already assigned to another object.
D & D History List
The options here let you control the drag and drop history list
that appears on the 'Open As' submenu.
maintain list
When checked, DTProgram will keep a list of the last 8 files
dropped on this program object. Unchecking this option prevents
DTProgram from updating the list but does not clear any existing
entries.
clear list
Pressing this deletes all entries currently on the list. This may
be desireable because the list can introduce a slight delay when
displaying this object's menu.
_______________________________________________________________________
Open As Submenu
_______________________________________________________________________
New Window / Existing Window
These menu entries let you override this object's default open
action without changing it.
'New Window' is always enabled. It is checked if there are no
open windows currently, or if the default is to open a new
window every time.
'Existing Window' is only enabled when this object is already
open. It is checked if the default action is to activate an
existing window.
Drag and Drop History List
Shows the last 8 files and directories dropped on this object.
Selecting one of them is identical to dropping that file on this
object once again.
Scheduled Date and Time
If you've set this object to open on schedule, the date and time
when it will next open appears at the top of the menu.
_______________________________________________________________________
Objects Submenu
_______________________________________________________________________
The Objects submenu offers an easy way to open objects related
to the current program. Use it with DragText's Window Links
feature to navigate the Desktop without having to open a folder
or find an icon.
The directory containing the program file, and the working
directory (if any) always appear on the menu. If there are files,
folders, or other programs you frequently open along with the
current program, add them to the menu using the WPS notebook's
Objects Page.
When Window Links is enabled, you can access this menu
directly from any window this program opens. Just click (or
Ctrl-click) MB2 on the window's system menu button.
_______________________________________________________________________
Close All Menu item
_______________________________________________________________________
Close all of this object's windows and programs from the icon
that opened them. Press Ctrl when selecting this item to kill
any running programs. This may allow you to terminate hung
programs that have no entries in the window list.
_______________________________________________________________________
Dropping Text on an Object
_______________________________________________________________________
You can use DragText to open an object by dropping text on it;
the dropped text will be used as a startup parameter.
By default, the dropped text will be appended to any existing
startup parameters with a space in between. You can have the
text inserted elsewhere by placing the '%*' substitution
characters at the appropriate place(s). DTProgram recognizes
other substitution sequences (e.g. '%**F') but handles them the
same as '%*'. It ignores the single '%' intended to prevent
startup parameters.
_______________________________________________________________________
Dropping Multiple Files
_______________________________________________________________________
When you drop several files on a program object, the WPS
normally opens each file in a separate copy of the program. The
icon for each file is shown as being in use, rather than the
program object.
With DTProgram, you can also have a single copy of the program
open all dropped files (if the program supports this). To do so,
press Ctrl-Shift when you drop them. DTProgram will open the
program object, passing the names of all dropped files as a
single startup parameter. Its icon, not the files', will be shown
as being in use.
The filenames will be joined with a space between each. If any
file's path contains a space, DTProgram will place quotes around
it. The resulting string will then be handled the same as
dropped text, as described above.
_______________________________________________________________________
Setup Strings
_______________________________________________________________________
These can be used with the REXX functions SysCreateObject and
SysSetObjectData to create and modify DTProgram objects.
Drag and Drop functions
DROPFILE = fully-qualified filename
Has the same effect as dropping the named file on this object:
the file is opened using this program to view it.
DROPTEXT = string of up to 255 characters
Has the same effect as using DragText to drop the text on this
object: this object is opened with the text inserted into the
command line parameters. See "Dropping Text on an Object" for
more details.
Schedule functions
DTProgram assumes that all scheduling setup strings should be
treated as a package. If any one of them contains an error, none
of them will be used.
SCHEDULE = ON | OFF
Add/Remove this object to/from the list of scheduled objects
DATE = yyyy/mm/dd
The next date that the object should be opened. The year must
have 4 digits, and the month and day must have 2 digits.
TIME = hh:mm:ss
The next time that the object should be opened. Taken with the
date, it must be at least 20 seconds in the future. Hours uses a
24 hour clock (e.g. 1PM is 13); hours, minutes, and seconds
must all be 2 digits.
REPEAT = ON | OFF
Set the object to reopen on a regular basis. The year must have
4 digits; the month and day must have 2.
ALWAYSOPEN = ON | OFF
If this object wasn't opened on schedule, open it as soon as
possible thereafter; otherwise, skip it.
_______________________________________________________________________
_______________________________________________________________________
About DragText
_______________________________________________________________________
_______________________________________________________________________
- DragText version 3.3 -
The Drag and Drop Enabler for OS/2*
(C) Copyright R L Walsh 1994 - 2000
All rights reserved.
write to
DragText@E-vertise.com
-- or --
Rich Walsh
315 S. Barbour St
Beverly Hills, Florida 34465
U.S.A.
Registering DragText
License Agreement
* OS/2 and Presentation Manager are trademarks of International
Business Machines Corp.
_______________________________________________________________________
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
The author can accept checks or money orders drawn in any
major currency.
U.S. Dollars: Registration is $20 if your 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
$25 converted into your national currency. You can
determine the exchange rate by asking your bank or looking
in the financial pages of your local newspaper.
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: DragText@E-vertise.com
BMT Micro
Registration is $20.
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
Internet: bmt@wilmington.net
http://www.bmtmicro.com
Compuserve: Thomas Bradford, 74031,307
AOL bmtmicro
BBS: (910) 350-8061 10 lines, all 14.4K
(910) 799-0923 28.8k v.FC
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.
_______________________________________________________________________
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, and
- there is no cost to the recipient other than the costs of
providing media and transmission.
You may not modify DragText in any way nor may you reverse
assemble, reverse compile, or otherwise translate or reverse
engineer its executable code or data. You may make additions to
the documentation, including translations into other languages,
provided these are contained in files separate from the originals
and are identified as addenda to the accompanying original
documentation.
DragText is not warranted to be free of defects nor to be
suitable for any particular purpose the licensee may put it to.
The licensee agrees to use DragText at his or her own risk, and
agrees to accept all liabilities arising from its use, including all
claims by third parties, without recourse to the author or
copyright holder.
THERE ARE NO WARRANTIES, EXPRESS OR IMPLIED, OF ANY
SORT. BY YOUR USE OF THE PROGRAM YOU AGREE TO THE
TERMS OF THIS LICENSE.
_______________________________________________________________________
_______________________________________________________________________
Appendix: Feature Summary
_______________________________________________________________________
_______________________________________________________________________
The following tables provide a complete listing of every
DragText feature that involves the use of MB2 (the drag button,
usually the right-hand one). DragText's WPS classes provide
additional features that are not included here.
Drag
Drop
Related Features
_______________________________________________________________________
Drag
_______________________________________________________________________
This table identifies:
What you can drag (Dragged Item)
Where it comes from (Drag Source)
How to drag it (Required Action)
┌────────────────────┬───────────────┬──────────────────────────────┐
│Dragged Item │Drag Source │Required Action │
├────────────────────┼───────────────┼──────────────────────────────┤
│Selected text * │most windows │highlight text, then drag │
│ │ │or press Alt-MB2 to pickup; │
├────────────────────┼───────────────┼──────────────────────────────┤
│All text * │MLE, Listbox, │press Ctrl, then drag or │
│ │& VIO windows │press Ctrl-Alt-MB2 to pickup; │
│ │ │ │
│ │Entryfield │drag without highlighting, │
│ │& Static text │or press Alt-MB2 to pickup; │
├────────────────────┼───────────────┼──────────────────────────────┤
│Clipboard text │DTClip icon │drag from icon, │
│ │ │or press Alt-MB2 to pickup; │
├────────────────────┼───────────────┼──────────────────────────────┤
│File or Object ID │most windows │highlight name or ID, │
│named in text │ │then Ctrl-Shift drag; │
├────────────────────┼───────────────┼──────────────────────────────┤
│Object that opened │Sysmenu │drag from sysmenu │
│this window │ │ │
├────────────────────┼───────────────┼──────────────────────────────┤
│Object being used │Sysmenu │Ctrl-drag from sysmenu │
│to view a file │ │ │
└────────────────────┴───────────────┴──────────────────────────────┘
* Basic (free) feature, except in VIO windows; all other
features require registration.
_______________________________________________________________________
Drop
_______________________________________________________________________
This table identifies:
Where you can drop (Drop Target)
What you can drop (Dragged Item)
Which key is required (Key to Press)
What will happen (Drop Result)
┌─────────────┬───────────────┬───────────────────────────┬──────────┐
│Drop Target │Dragged Item │Drop Result │Key │
├─────────────┼───────────────┼───────────────────────────┼──────────┤
│Text Window │Dragged text │insert text * │ │
│ │DTFile │insert contents │ │
│ │Url object │insert contents │ │
│ │File / Object │insert path * │ │
│ │ │insert name only * │Shift │
│ │File │insert directory entry + │Ctrl │
│ │ │insert contents + │Alt │
│ │Folder │insert formatted listing + │Alt │
│ │Unknown item │insert app-specific text * │Alt │
├─────────────┼───────────────┼───────────────────────────┼──────────┤
│Folder │Dragged text │create file │ │
│ │Url text │create Url object │ │
├─────────────┼───────────────┼───────────────────────────┼──────────┤
│System Menu │File / Object │locate object │ │
│Button │ │open object │Alt │
│ │ │popup object's WPS menu │Ctrl │
├─────────────┼───────────────┼───────────────────────────┼──────────┤
│Titlebar │same as │copy to DTClip viewer │ │
│ │Text Window │ │ │
├─────────────┼───────────────┼───────────────────────────┼──────────┤
│DTClip Icon │same as │copy to clipboard │ │
│ │Text Window │append to clipboard │[Insert] %│
├─────────────┼───────────────┼───────────────────────────┼──────────┤
│DTFile Icon │same as │append to file │ │
│ │Text Window │ │ │
├─────────────┼───────────────┼───────────────────────────┼──────────┤
│DTProgram │Dragged text │open using text │ │
│Icon │ │as startup parameter; │ │
│ │Multiple files │open using filenames │ │
│ │ │as startup parameter; │Ctrl-Shift│
└─────────────┴───────────────┴───────────────────────────┴──────────┘
Note: to drop an object you have picked up, press Ctrl or Shift
(to copy or move), then click MB2. To cancel a pickup,
Alt-click MB2 on the Desktop or a DragText-enabled window.
* Basic (free) feature; all others require registration.
+ supported only in these windows/objects: MLE, VIO,
Titlebar, DTClip, DTFile
% press and release Insert while over a DTClip icon to toggle
between append and replace modes
_______________________________________________________________________
Related Features
_______________________________________________________________________
This table identifies:
What else DT does (Feature)
Where to use it (Window)
How to use it (Usage)
What it does (Result)
┌──────────┬────────┬────────────────────────┬────────────────────────┐
│Feature │Window │Usage │Result │
├──────────┼────────┼────────────────────────┼────────────────────────┤
│Window │Sysmenu │click MB2 │show menu of object that│
│Link │button │ │opened this window │
│Menus │ │Ctrl-click MB2 │menu of program object │
│ │ │ │used to open this window│
├──────────┼────────┼────────────────────────┼────────────────────────┤
│Text Link │text │Ctrl-Shift-click MB2 │show menu for selected │
│Menus │windows │or Ctrl-Shift F10 │filename or object ID │
├──────────┼────────┼────────────────────────┼────────────────────────┤
│Mouse │VIO │drag while pressing MB1 │mark text │
│Marking + │ │press MB2 while marking │copy to clipboard │
│ │ │press MB1+MB2 │paste from clipboard │
├──────────┼────────┼────────────────────────┼────────────────────────┤
│Background│most │actions using MB2 │window won't activate or│
│Drag * │windows │ │be brought to the top │
└──────────┴────────┴────────────────────────┴────────────────────────┘
* Basic (free) feature; all others require registration.
+ Options permit selection of MB1 or MB3 for marking, and
whether selected keys must be pressed to activate this
feature.
_______________________________________________________________________
_______________________________________________________________________